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

Kayıt Bildirimi

Bir kaydı bildirmek basittir. Bir kaydı, record anahtar kelimesi, ardından tür (sınıf veya yapı) ve kaydın adı ile tanımlayabilirsiniz. Örneğin, basit bir kişi kaydı şu şekilde bildirilebilir:

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 bildirim, FirstName ve LastName için konumsal parametreler içerir, bu sayede bu özellikler için genel özellikler ve birincil bir yapıcı oluşturulur.

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

Bir değişmez kayıt yapısı, kayıt sınıfına benzer şekilde, ancak kayıt yapısı sözdizimi kullanılarak bildirilir. Bu, kayıtların değişmezliğini ve değer bazlı karşılaştırmasını değer tipinin performans avantajları ile 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 iki kişi kaydının nasıl oluşturulduğuna bakalım:

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ş2 ve kiş1 iki farklı örnek olmasına rağmen, özellik değerlerine dayalı olarak eşit kabul edilirler ve bu da değer bazlı eşitliği sergiler. Bu, varsayılan davranışı referans eşitliğine odaklanan referans türlerinden önemli bir ayrılıştır.

Değişmez Özellikler

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

// 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ıtlarda Kalıtım

Kayıtlar, veri modeli hiyerarşisi oluşturmanıza izin vererek kalıtımı destekler. Bir temel kaydı şu şekilde genişletebilirsiniz:

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ı Kişi'yi genişleterek ek Bölüm özelliğini ekler.

Tahribatsız Değişim

Kayıtlar, mevcut bir kayıttan bazı özellikler değiştirilerek yeni bir kayıt örneği oluşturmak için yerleşik bir yöntem sağlar, bu tahribatsız 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 Formatlama

Kayıtlar, hata ayıklama ve günlük tutmayı kolaylaştırmak için, özelliklerinin otomatik bir dize temsili sağlamak için yerleşik formatlama ile birlikte gelir.

Console.WriteLine(person1);

Console.WriteLine(person1);

Console.WriteLine(person1)

IronPDF Kütüphanesi Nasıl Kurulur

IronPDF'in kurulumu basittir ve Visual Studio'da NuGet Paket Yöneticisi aracılığıyla gerçekleştirilebilir. Bu adımları takip edin:

1. Visual Studio'da Çözüm Gezgini'ne gidin, Referanslar kısmına sağ tıklayın ve NuGet Paketlerini Yönet seçeneğini seçin.
2. NuGet Paket Yöneticisi'nde, Göz At'ı seçin ve "IronPDF" arayın.
3. IronPDF paketini bulun ve Yükle'ye tıklayın.

Alternatif olarak, Paket Yöneticisi Konsolu'nu kullanarak aşağıdaki komutla kurabilirsiniz:

Install-Package IronPdf

Örnek: IronPDF ile C# Kaydı Kullanmak

C# kaydını veri tutmak için kullanarak IronPDF ile bir PDF belgesi oluşturduğumuz pratik bir örnek göz önüne 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 Kişi kaydı oluşturur ve ardından IronPDF kullanarak kişinin adını görüntüleyen bir PDF belgesi oluşturur. Bu, .NET uygulamalarında C# kayıtlarının, PDF oluşturma ile nasıl sorunsuz bir şekilde entegre olabildiğini göstermektedir.

IronPDF Lisanslama

IronPDF, çeşitli ihtiyaçlara yönelik farklı lisanslar sunan ticari bir üründür, bireysel ve ticari seçenekler de dahil. Her satın alım, ömür boyu lisans ve 30 günlük para iade garantisi ile birlikte gelir. IronPDF Lisans Seçeneklerini Keşfedin lisansı satın almadan önce.