C# Nullable Türler (Geliştiriciler İçin Nasıl Çalışır)

C#'ta Nullable Türler

Varsayılan olarak, C#'taki değer türleri (örneğin, int, bool, DateTime) null değerleri alamaz. Bu sınırlamayı aşmak için, C# nullable değer türlerini tanıtır ve değer türlerine null atayabilmenizi sağlar. Nullable türler, geçerli bir değerin yokluğunu temsil etmeniz gerektiğinde özellikle kullanışlıdır.

// Declare a nullable integer
int? nullableInt = null;

// Declare a nullable integer
int? nullableInt = null;

' Declare a nullable integer
Dim nullableInt? As Integer = Nothing

if (nullableInt.HasValue)
{
    // If nullableInt has a value, print it
    Console.WriteLine("Value: " + nullableInt.Value);
}
else
{
    // If nullableInt does not have a value, print a message
    Console.WriteLine("No value assigned.");
}

if (nullableInt.HasValue)
{
    // If nullableInt has a value, print it
    Console.WriteLine("Value: " + nullableInt.Value);
}
else
{
    // If nullableInt does not have a value, print a message
    Console.WriteLine("No value assigned.");
}

If nullableInt.HasValue Then
	' If nullableInt has a value, print it
	Console.WriteLine("Value: " & nullableInt.Value)
Else
	' If nullableInt does not have a value, print a message
	Console.WriteLine("No value assigned.")
End If

// Assign 0 if nullableInt is null
int result = nullableInt ?? 0;
Console.WriteLine("Result: " + result);

// Assign 0 if nullableInt is null
int result = nullableInt ?? 0;
Console.WriteLine("Result: " + result);

' Assign 0 if nullableInt is null
Dim result As Integer = If(nullableInt, 0)
Console.WriteLine("Result: " & result)

Nullable Değer Türleri ile Nullable Referans Türleri

C#'ta değer türleri (örneğin, int, bool ve double), referans türlerinden (örneğin, string, object) farklıdır. Nullable değer türleri, değer türlerinin null'u temsil etmesine izin verirken, nullable referans türleri, referans türlerinin varsayılan olarak null olmamasını sağlar, bu da null referans hatası riskini azaltır.

// Declare a nullable double
double? nullableDouble = null;

// Declare a nullable double
double? nullableDouble = null;

' Declare a nullable double
Dim nullableDouble? As Double = Nothing

# nullable enable
// Declare a nullable string
string? nullableString = null;

# nullable enable
// Declare a nullable string
string? nullableString = null;

<Nullable>enable</Nullable>

<Nullable>enable</Nullable>

Uygulamalı Örnekler

Null türleri anlamanızı pekiştirmek için bazı pratik örnekleri keşfedelim.

class Program
{
    static void Main(string[] args)
    {
        int? nullableInt = null;
        // Use null coalescing operator to assign a default value
        int b = nullableInt ?? 10;
        Console.WriteLine("b: " + b);
        if (nullableInt.HasValue)
        {
            // nullableInt has a value
            Console.WriteLine("nullableInt has value: " + nullableInt.Value);
        }
        else
        {
            // nullableInt is null
            Console.WriteLine("nullableInt is null");
        }
    }
}

class Program
{
    static void Main(string[] args)
    {
        int? nullableInt = null;
        // Use null coalescing operator to assign a default value
        int b = nullableInt ?? 10;
        Console.WriteLine("b: " + b);
        if (nullableInt.HasValue)
        {
            // nullableInt has a value
            Console.WriteLine("nullableInt has value: " + nullableInt.Value);
        }
        else
        {
            // nullableInt is null
            Console.WriteLine("nullableInt is null");
        }
    }
}

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim nullableInt? As Integer = Nothing
		' Use null coalescing operator to assign a default value
		Dim b As Integer = If(nullableInt, 10)
		Console.WriteLine("b: " & b)
		If nullableInt.HasValue Then
			' nullableInt has a value
			Console.WriteLine("nullableInt has value: " & nullableInt.Value)
		Else
			' nullableInt is null
			Console.WriteLine("nullableInt is null")
		End If
	End Sub
End Class

# nullable enable
class Program
{
    static void Main()
    {
        string? nullableString = null;
        string nonNullableString = "Hello";
        // Use null coalescing operator to provide a default value for length
        Console.WriteLine(nullableString?.Length ?? 0);
        Console.WriteLine(nonNullableString.Length);
    }
}

# nullable enable
class Program
{
    static void Main()
    {
        string? nullableString = null;
        string nonNullableString = "Hello";
        // Use null coalescing operator to provide a default value for length
        Console.WriteLine(nullableString?.Length ?? 0);
        Console.WriteLine(nonNullableString.Length);
    }
}

Option Strict On



Module Program
    Sub Main()
        Dim nullableString As String = Nothing
        Dim nonNullableString As String = "Hello"
        ' Use null coalescing operator to provide a default value for length
        Console.WriteLine(If(nullableString?.Length, 0))
        Console.WriteLine(nonNullableString.Length)
    End Sub
End Module

// Redundant, but syntactically valid
int? nestedNullableInt = null;

// Redundant, but syntactically valid
int? nestedNullableInt = null;

' Redundant, but syntactically valid
Dim nestedNullableInt? As Integer = Nothing

Null Birleştirme Operatörü (??)

Null birleştirme operatörü (??), nullable türler ile sıklıkla kullanılır ve nullable tür null olduğunda varsayılan bir değer sağlar. Bu operatör, açık if-else kontrollerini önleyerek kodu basitleştirir.

int? nullableValue = null;
// Assign -1 if nullableValue is null
int defaultValue = nullableValue ?? -1;

int? nullableValue = null;
// Assign -1 if nullableValue is null
int defaultValue = nullableValue ?? -1;

Dim nullableValue? As Integer = Nothing
' Assign -1 if nullableValue is null
Dim defaultValue As Integer = If(nullableValue, -1)

Bu örnekte, nullableValue null ise, defaultValue -1 atanacaktır. Aksi durumda, defaultValue, nullableValue değerini alır.

Derleme Zamanı Hataları ve Nullable Türler

Nullable referans türleri etkinleştirildiğinde, C# null atamalarla ilgili potansiyel sorunları tespit ettiğinde derleme sırasında uyarılar ve hatalar üretir. Bu derleme zamanı hataları, sorunları erken yakalamanıza yardımcı olarak kodunuzu daha sağlam hale getirir.

Aşağıdaki örneği inceleyin:

string? nullableString = null;
// This will produce a compiler warning because nullableString may be null
string nonNullableString = nullableString;

string? nullableString = null;
// This will produce a compiler warning because nullableString may be null
string nonNullableString = nullableString;

'INSTANT VB WARNING: Nullable reference types have no equivalent in VB:
'ORIGINAL LINE: string? nullableString = null;
Dim nullableString As String = Nothing
' This will produce a compiler warning because nullableString may be null
Dim nonNullableString As String = nullableString

Bu durumda, nullableString'yi nonNullableString'ye atamak, nullableString null olabileceği için derleyici uyarısı üretir ve boş olmayan bir türe atama yapmak çalışma zamanı istisnalarına yol açabilir.

IronPDF ile Nullable Türleri Kullanma

IronPDF, geliştiricilere doğrudan .NET uygulamalarından PDF dosyaları oluşturma, düzenleme ve yönetme konularında yardımcı olmak için tasarlanmış bir C# PDF kütüphanesidir. HTML'yi PDF'ye dönüştürebilir, raporlar üretebilir veya karmaşık belge yapıları ile uğraşabilirsiniz.

Null türler, özellikle eksik finansal verilerle bir muhasebeci için PDF oluştururken olduğu gibi dinamik rapor üretim senaryolarında özellikle kullanışlıdır. Null türleri kullanarak, opsiyonel alanları yönetebilir, istisnalardan kaçınabilir ve varsayılan değerler sağlayabilirsiniz.

using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        int? optionalIncome = null;  // Nullable type for optional income
        string? clientName = "Iron Dev";  // Nullable reference type for client name
        var renderer = new ChromePdfRenderer();
        string htmlContent = $@"
            <h1>Financial Report</h1>
            <p>Client Name: {clientName ?? "Unknown"}</p>
            <p>Income: {optionalIncome?.ToString() ?? "Data not available"}</p>";
        // Render the HTML to a PDF
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        // Save the PDF to disk
        pdf.SaveAs("FinancialReport.pdf");
        Console.WriteLine("PDF Generated Successfully.");
    }
}

using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        int? optionalIncome = null;  // Nullable type for optional income
        string? clientName = "Iron Dev";  // Nullable reference type for client name
        var renderer = new ChromePdfRenderer();
        string htmlContent = $@"
            <h1>Financial Report</h1>
            <p>Client Name: {clientName ?? "Unknown"}</p>
            <p>Income: {optionalIncome?.ToString() ?? "Data not available"}</p>";
        // Render the HTML to a PDF
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        // Save the PDF to disk
        pdf.SaveAs("FinancialReport.pdf");
        Console.WriteLine("PDF Generated Successfully.");
    }
}

Imports IronPdf
Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim optionalIncome? As Integer = Nothing ' Nullable type for optional income
'INSTANT VB WARNING: Nullable reference types have no equivalent in VB:
'ORIGINAL LINE: string? clientName = "Iron Dev";
		Dim clientName As String = "Iron Dev" ' Nullable reference type for client name
		Dim renderer = New ChromePdfRenderer()
		Dim htmlContent As String = $"
            <h1>Financial Report</h1>
            <p>Client Name: {If(clientName, "Unknown")}</p>ignoreignore<p>Income: {If(optionalIncome?.ToString(), "Data not available")}</p>"
		' Render the HTML to a PDF
		Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
		' Save the PDF to disk
		pdf.SaveAs("FinancialReport.pdf")
		Console.WriteLine("PDF Generated Successfully.")
	End Sub
End Class

Bu kodda, boş türler (int? ve string?) eksik veriyi güvenli bir şekilde işlemek için kullanılır. Null birleştirme operatörü (??), herhangi bir veri eksik olduğunda, PDF'de varsayılan bir değerin kullanılmasını sağlar.

Sonuç

C#'ta nullable türler, hem değer türlerinde hem de referans türlerinde null değerleri ele almak için güçlü bir araçtır. Nullable türler kullanarak, null referans hatalarından kaçınabilir ve kodunuzu daha sağlam hale getirebilirsiniz. Compile-time hata kontrolünden yararlanmak için yeni projelerde nullable referans türlerini etkinleştirmeyi ve nullable tiplerle çalışırken kodunuzu basitleştirmek için null birleştirme operatörünü (??) kullanmayı unutmayın.

IronPDF, özelliklerini bir taahhüt vermeden önce keşfetmenize olanak sağlamak için bir ücretsiz deneme sunar. Ön ödeme yapmadan, sürecinize nasıl uyduğunu değerlendirebilir ve deneyebilirsiniz. İlerlemenize hazır olduğunuzda, lisanslar $799 ile başlamaktadır.