Podczas pracy z C# często trzeba obsługiwac wartosci null, zwlaszcza przy typach referencyjnych. Typy nullable w C# oferuja sposob reprezentowania nieokreslonych lub zabrakujacych wartosci dla typow wartosciowych. Ten przewodnik obejmuje podstawy typow nullable w C#, ich praktyczne zastosowania oraz jak działaja w różnych sytuacjach. W dalszej części artykułu zajmiemy sie również IronPDF.
Domyslnie typy wartosciowe w C# (np. int, bool, DateTime) nie mogą być przypisane wartosciom null. Aby rozwiązać to ograniczenie, C# wprowadza typy wartosciowe nullable, ktore pozwalają na przypisanie null do typow wartosciowych. Typy nullable sa szczegółnie przydatne, gdy trzeba przedstawic brak ważnej wartosci.
Aby zadeklarowac typ nullable w C#, uzyj następującej skladni:
// Declare a nullable integer
int? nullableInt = null;' Declare a nullable integer
Dim nullableInt? As Integer = NothingTutaj, int? jest skrótem dla Nullable<int>. Zmiennej nullableInt można przypisać wartość typu int lub null.
Aby sprawdzić, czy zmienna nullable ma wartość, czy nie, można użyć właściwości HasValue albo porównać zmienną bezpośrednio z null, jak pokazano poniżej:
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 IfAlternatywnie, można uzyc operatora ??, aby zapewnic wartosc domyslna, gdy typ nullable jest nullem:
// 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)Jeśli nullableInt jest null, to result zostanie przypisane wartością domyślną 0.
W C# typy wartosciowe (takie jak int, bool, double) różnią sie od typow referencyjnych (jak string, object). Typy wartosciowe nullable pozwalają na reprezentowanie null przez typy wartosciowe, podczas gdy typy referencyjne nullable pozwalają na domyslna deklaracje typow referencyjnych jako non-nullable, zmniejszajac tym samym ryzyko wyjątków referencji null.
Typ wartosciowy nullable pozwala na przypisanie wartosci null do typu wartosciowego. Aby zadeklarować typ nullable, dodaj znak zapytania ? do typu danych:
// Declare a nullable double
double? nullableDouble = null;' Declare a nullable double
Dim nullableDouble? As Double = NothingW tym przykładzie nullableDouble może przechowywać wartość double lub null.
Nullable reference types zostały wprowadzone w C# 8.0. Można je włączyć na poziomie projektu lub poprzez dodanie dyrektywy #nullable enable na początku pliku kodu. Po włączeniu nullable reference types typy referencyjne muszą być wyraźnie oznaczone jako nullable za pomocą ?, co pomaga uniknąć potencjalnych wyjątków w czasie wykonania spowodowanych przez null.
#nullable enable
// Declare a nullable string
string? nullableString = null;'INSTANT VB TODO TASK: There is no equivalent to #nullable in VB:
'#nullable enable
' Declare a nullable string
'INSTANT VB WARNING: Nullable reference types have no equivalent in VB:
'ORIGINAL LINE: string? nullableString = null;
Dim nullableString As String = NothingTutaj, nullableString może być null. Jeśli zadeklarujesz typ referencyjny non-nullable bez ?, kompilator wygeneruje ostrzeżenia, jeśli wykryje potencjalne przypisania null.
Aby globalnie włączyć nullable reference types w projekcie, dodaj następującą linię do pliku .csproj:
<Nullable>enable</Nullable>Po włączeniu, kompilator będzie traktował typy referencyjne jako domyślnie non-nullable. Ta funkcja jest szczególnie przydatna do wychwytywania problemów z referencjami do null podczas kompilacji, a nie podczas wykonywania.
Przyjrzyjmy się kilku praktycznym przykładom, aby utrwalić zrozumienie typów nullable.
W tym przykładzie użyjemy typu nullable z int:
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 ClassTutaj, nullableInt jest zmienną typu nullable int. Jeśli nullableInt jest null, to b przyjmie wartość 10 dzięki operatorowi złączenia null. W przeciwnym razie b przyjmie wartość nullableInt.
Teraz zobaczmy, jak działają typy referencyjne nullable:
#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);
}
}'INSTANT VB TODO TASK: There is no equivalent to #nullable in VB:
'#nullable enable
Friend Class Program
Shared Sub Main()
'INSTANT VB WARNING: Nullable reference types have no equivalent in VB:
'ORIGINAL LINE: string? nullableString = null;
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 ClassW powyższym kodzie nullableString może być null, a operator złączenia null zapewnia, że jeśli jest null, to długość ciągu jest domyślnie 0.
C# pozwala deklarować zagnieżdżone typy nullable. Na przykład:
// Redundant, but syntactically valid
int? nestedNullableInt = null;' Redundant, but syntactically valid
Dim nestedNullableInt? As Integer = NothingChociaż zagnieżdżone typy nullable mogą wydawać się redundantne, są składniowo poprawne w C#. Jednak w praktyce zagnieżdżone typy nullable nie oferują żadnej dodatkowej funkcjonalności i są rzadko używane.
Operator ?? jest często używany z typami nullable, aby zapewnić wartość domyślną, gdy typ nullable jest null. Ten operator upraszcza kod, unikając jawnych instrukcji if-else.
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)W tym przykładzie, jeśli nullableValue jest null, to defaultValue zostanie przypisane -1. W przeciwnym razie defaultValue przyjmie wartość nullableValue.
Przy włączonych typach referencyjnych nullable, C# generuje ostrzeżenia i błędy podczas kompilacji, gdy wykryje potencjalne problemy z przypisaniami null. Te błędy kompilacji pomagają wcześnie wychwycić problemy, czyniąc twój kod bardziej solidnym.
Rozważmy następujący przykład:
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 = nullableStringW tym przypadku przypisanie nullableString do nonNullableString powoduje ostrzeżenie kompilatora, ponieważ nullableString może być null, a przypisanie go do typu non-nullable może prowadzić do wyjątków w czasie wykonania.
IronPDF to biblioteka PDF dla C# zaprojektowana, aby pomagać deweloperom tworzyć, edytować i manipulować plikami PDF bezpośrednio w aplikacjach .NET. Można konwertować HTML na PDF, generować raporty lub nawet obsługiwac zlozone struktury dokumentów.
Typy nullable sa szczegółnie przydatne w scenariuszach generowania dynamicznych raportow, takich jak generowanie PDF dla ksiegowego z niepełna dane finansowe. Używając typow nullable, możesz obsługiwac opcjonalne pola, unikac wyjątków i zapewnic wartosci domyslne.
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
W tym kodzie typy nullable (int? i string?) są używane do bezpiecznego obsługiwania brakujących danych. Operator ?? zapewnia, ze jeśli jakiekolwiek dane są brakujace, w PDF zostanie uzuta wartosc domyslna.
Typy nullable w C# są potężnym narzędziem do obsługi wartości null zarówno w typach wartościowych, jak i referencyjnych. Dzięki nim można uniknąć wyjątków referencyjnych null i zwiększyć odporność kodu. Pamiętaj, aby włączyć typy referencyjne nullable w nowych projektach, aby korzystać ze sprawdzania błędów podczas kompilacji. Używaj operatora ??, aby upraszczać kod przy obsłudze typów nullable.
IronPDF oferuje bezplataną wersję próbną, aby pomóc ci odkryć jego funkcje, zanim podejmiesz decyzję. Bez wstępnych opłat możesz przetestować i sprawdzić, jak wpasowuje się w twój proces deweloperski. Gdy już będziesz gotowy na kolejny krok, licencje zaczynają się od $999.
Jacob Mellor jest Chief Technology Officer w Iron Software i wizjonerskim inżynierem, pionierem technologii C# PDF. Jako pierwotny deweloper głównej bazy kodowej Iron Software, kształtuje architekturę produktów firmy od jej początku, przekształcając ją wspólnie z CEO Cameron Rimington w firmę liczącą ponad 50 osób, obsługującą NASA, Teslę i światowe agencje rządowe.
IronPDF jest częścią IRONSUITE
10 produktów API .NET dla twoich dokumentów biurowych
Kiedy potrzebujesz, aby twój PDF wyglądał jak HTML, szybko.
