C# Record (Geliştiriciler için Nasıl Çalışır)

Kayıt Deklarasyonu

Bir kaydı tanımlamak basittir. record anahtar sözcüğü ile kayıt türünü (sınıf veya yapı) ve kayıt adını belirtmek suretiyle bir kayıt tanımlayabilirsiniz. Örneğin, basit bir kişi kaydı şu şekilde tanımlanabilir:

public record class Person(string FirstName, string LastName);

public record class Person(string FirstName, string LastName);

'INSTANT VB TODO TASK: C# 'records' are not converted by Instant VB:
'public record class Person(string FirstName, string LastName)

Bu tanım, kaputun altında, bu özellikler için genel özellikler ve birincil bir yapıcı üreten İsim ve Soyisim için konumlu parametrelere sahiptir.

Değişmez Kayıt Yapısı

Bir değişmez kayıt yapı, bir kayıt sınıfıyla benzer şekilde ancak record struct sözdizimini kullanarak tanımlanır. Bu, kayıtların değişmezliği ve değer bazlı karşılaştırması ile bir değer türünün performans avantajlarını birleştirir:

public readonly record struct ImmutablePerson(string FirstName, string LastName);

public readonly record struct ImmutablePerson(string FirstName, string LastName);

'INSTANT VB TODO TASK: C# 'records' are not converted by Instant VB:
'public readonly record struct ImmutablePerson(string FirstName, string LastName)

Kayıtları Oluşturma ve Karşılaştırma

Aşağıdaki örnekte, bir kişi kaydının iki örneğini oluşturuyoruz:

var person1 = new Person("Iron", "Software");
var person2 = new Person("Iron", "Software");
Console.WriteLine(person1 == person2); // Output: True

var person1 = new Person("Iron", "Software");
var person2 = new Person("Iron", "Software");
Console.WriteLine(person1 == person2); // Output: True

Dim person1 = New Person("Iron", "Software")
Dim person2 = New Person("Iron", "Software")
Console.WriteLine(person1 = person2) ' Output: True

kişi1 ve kişi2 farklı örnekler olmasına rağmen, özellik değerlerine dayanarak eşit kabul edilirler ve bu da değer bazlı eşitliği sergiler. Bu, referans türlerinin varsayılan davranışından önemli bir sapmadır, referans eşitliğine odaklanır.

Değişmez Özellikler

Tasarım gereği, kayıt özellikleri değişmezdir. Yani bir kayıt örneği oluşturulduktan sonra özellik değerlerini değiştiremezsiniz.

// This will result in a compilation error
// person1.FirstName = "Jane";

// This will result in a compilation error
// person1.FirstName = "Jane";

' This will result in a compilation error
' person1.FirstName = "Jane";

Kayıtlarla Kalıtım

Kayıtlar, veri modelleri hiyerarşisi oluşturmanıza izin vererek kalıtım desteği sunar. İşte nasıl bir temel kaydı genişletebileceğiniz:

public record Employee(string FirstName, string LastName, string Department) : Person(FirstName, LastName);

public record Employee(string FirstName, string LastName, string Department) : Person(FirstName, LastName);

'INSTANT VB TODO TASK: C# 'records' are not converted by Instant VB:
'public record Employee(string FirstName, string LastName, string Department) : Person(FirstName, LastName)

Bu Çalışan kaydı, ek olarak Departman özelliğini ekleyerek Kişi kaydını genişletir.

Yıkıcı Olmayan Değişim

Kayıtlar, mevcut bir kayıt örneğinden bazı özellikleri değiştirilmiş yeni bir kayıt örneği oluşturmak için yerleşik bir yöntem sağlar, bu, yıkıcı olmayan değişim olarak bilinir.

var updatedPerson = person1 with { FirstName = "Jane" };

var updatedPerson = person1 with { FirstName = "Jane" };

'INSTANT VB TODO TASK: C# 'with expressions' are not converted by Instant VB:
'var updatedPerson = person1 with { FirstName = "Jane" }

Yerleşik Biçimlendirme

Kayıtlar, hata ayıklama ve günlük kaydı için varsayılan olarak kolaylık sağlayan özelliklerini otomatik olarak özellik gösterimi olarak sağlayan yerleşik biçimlendirme sağlar.

Console.WriteLine(person1);

Console.WriteLine(person1);

Console.WriteLine(person1)

IronPDF Kütüphanesini Nasıl Yüklerim

IronPDF'i yüklemek basittir ve Visual Studio'daki NuGet Paket Yöneticisi aracılığıyla gerçekleştirilebilir. Aşağıdaki adımları izleyin:

1. Visual Studio'da, Çözüm Gezgini'ne gidin, Referanslar'a sağ tıklayın ve NuGet Paketlerini Yönet'i seçin.
2. NuGet Paket Yöneticisi'nde Gözat'ı seçin ve "IronPdf" arayın.
3. IronPDF paketini bulun ve Install'a tıklayın.

Alternatif olarak, Paket Yöneticisi Konsolu'nu kullanarak şu komut ile kurabilirsiniz:

Install-Package IronPdf

Örnek: C# Record'u IronPDF ile Kullanma

Bir PDF belgesi oluşturmak için verileri tutmakta bir C# kaydını kullandığımız pratik bir örneği ele alalım:

public record Person(string FirstName, string LastName);

class Program
{
    static void Main(string[] args)
    {
        // Create an instance of the Person record.
        var person = new Person("Iron", "Developer");

        // Initialize a new renderer object for generating PDF files using Chrome's rendering engine.
        var renderer = new IronPdf.Rendering.ChromePdfRenderer();

        // Render an HTML string as a PDF document.
        var pdf = renderer.RenderHtmlAsPdf($"<h1>Person Record</h1><p>Name: {person.FirstName} {person.LastName}</p>");

        // Save the PDF to the specified location.
        pdf.SaveAs("PersonRecord.pdf");
    }
}

public record Person(string FirstName, string LastName);

class Program
{
    static void Main(string[] args)
    {
        // Create an instance of the Person record.
        var person = new Person("Iron", "Developer");

        // Initialize a new renderer object for generating PDF files using Chrome's rendering engine.
        var renderer = new IronPdf.Rendering.ChromePdfRenderer();

        // Render an HTML string as a PDF document.
        var pdf = renderer.RenderHtmlAsPdf($"<h1>Person Record</h1><p>Name: {person.FirstName} {person.LastName}</p>");

        // Save the PDF to the specified location.
        pdf.SaveAs("PersonRecord.pdf");
    }
}

'INSTANT VB TODO TASK: C# 'records' are not converted by Instant VB:
'public record Person(string FirstName, string LastName)

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Create an instance of the Person record.
		Dim person As New Person("Iron", "Developer")

		' Initialize a new renderer object for generating PDF files using Chrome's rendering engine.
		Dim renderer = New IronPdf.Rendering.ChromePdfRenderer()

		' Render an HTML string as a PDF document.
		Dim pdf = renderer.RenderHtmlAsPdf($"<h1>Person Record</h1><p>Name: {person.FirstName} {person.LastName}</p>")

		' Save the PDF to the specified location.
		pdf.SaveAs("PersonRecord.pdf")
	End Sub
End Class

Bu örnek, basit bir Person kaydı oluşturur ve ardından kişinin adını görüntüleyen bir PDF belgesi oluşturmak için IronPDF'yi kullanır. Bu örnek, C# kayıtlarının .NET uygulamalarında PDF oluşturma ile nasıl sorunsuz entegre olabileceğini göstermektedir.

IronPDF Lisanslama

IronPDF, bireysel ve ticari seçenekler dahil olmak üzere çeşitli ihtiyaçlara göre özelleştirilmiş çeşitli lisanslar sunan ticari bir üründür. Her satın alma ömür boyu lisans ve 30 günlük para iade garantisi ile gelir. IronPDF Lisans Seçeneklerini Keşfedin lisansı satın almadan önce.