Coalescência de valores nulos em C# (Como funciona para desenvolvedores)

Sintaxe

A seguir, apresentamos a sintaxe do operador de coalescência nula:

result = expression1 ?? expression2;

result = expression1 ?? expression2;

result = If(expression1, expression2)

• expressão1: Esta expressão pode produzir um valor nulo.
• expressão2: Se expressão1 for nula, este será o valor padrão ou a expressão substituta a ser usada.
• resultado: A variável que contém o resultado da operação de coalescência.

O operador de coalescência nula oferece um método conciso para atribuir um valor padrão ao trabalhar com tipos anuláveis, sendo seu principal objetivo simplificar o código e lidar eficientemente com dados nulos.

Benefícios

• Concisão: Lida com verificações de valores nulos sem exigir instruções condicionais complexas ou operadores ternários.
• Legibilidade do código: Melhorada ao declarar explicitamente que um valor padrão será fornecido caso o resultado seja nulo.

É crucial garantir que os tipos de expressão que estão sendo comparados correspondam ou sejam compatíveis antes de usar o operador de coalescência nula.

Embora útil, o uso excessivo do operador pode dificultar a compreensão do código. Use-o com moderação, apenas quando melhorar a clareza do código.

Ao trabalhar com tipos anuláveis ​​ou cenários que exigem valores padrão, o operador de coalescência nula (??) em C# é uma ferramenta eficaz para gerenciar valores nulos e pode ajudar a escrever um código mais conciso e compreensível.

O operador de coalescência nula ?? Possui as seguintes qualidades relacionadas ao tipo:

Inferência do tipo de resultado

O tipo de resultado do operador de coalescência nula é o mesmo que esses operandos se as expressões 1 e 2 tiverem o mesmo tipo, conforme mostrado no código a seguir.

int? Value = null;
int result = Value ?? 10;

int? Value = null;
int result = Value ?? 10;

Dim Value? As Integer = Nothing
Dim result As Integer = If(Value, 10)

Compatibilidade de tipos

O tipo de resultado é o tipo para o qual ambas as expressões podem ser convertidas implicitamente se as expressões 1 e 2 tiverem tipos distintos, mas uma puder ser convertida implicitamente na outra.

double? value = null;
int result = (int)(value ?? 5.5);

double? value = null;
int result = (int)(value ?? 5.5);

Imports System

Dim value? As Double = Nothing
Dim result As Integer = CInt(Math.Truncate(If(value, 5.5)))

Tipo de promoção

Se os tipos das expressões 1 e 2 não puderem ser convertidos implicitamente, o tipo resultante será escolhido seguindo as regras de promoção de tipo do C#.

int? value = null;
long result = value ?? 100L;

int? value = null;
long result = value ?? 100L;

Dim value? As Integer = Nothing
Dim result As Long = If(value, 100L)

Consequentemente, os tipos dos operandos envolvidos e as regras de conversão de tipo do C# ditam o tipo de variável ou expressão que contém o resultado do operador de coalescência nula (??). Para garantir o tratamento correto de tipos e valores ao empregar o operador de coalescência nula, é crucial levar em consideração a compatibilidade e as prováveis ​​conversões de tipo.

Instale o IronPDF

Para instalar a biblioteca IronPDF , insira o seguinte código no Gerenciador de Pacotes:

Install-Package IronPdf

Alternativamente, você pode usar o Gerenciador de Pacotes NuGet para procurar o pacote "IronPDF". Você pode escolher e baixar o pacote necessário desta lista de todos os pacotes NuGet relacionados ao IronPDF.

Criar PDF com coalescência nula

A biblioteca C# chamada IronPDF é usada para criar e trabalhar com documentos PDF. A biblioteca oferece recursos para trabalhar com PDFs, como formatação, processamento de texto e gerenciamento de imagens. "Coalescência nula" não é um método ou recurso exclusivo do IronPDF; Na verdade, trata-se de uma característica da linguagem, e não de uma operação específica da biblioteca.

No entanto, se você estiver trabalhando com o IronPDF ou qualquer outra biblioteca em seu código C#, poderá utilizar os operadores de coalescência nula (??) que a linguagem C# fornece.

Para lidar com situações nulas ou fornecer valores padrão, por exemplo, ao trabalhar com objetos IronPDF , tipos de valores anuláveis ​​ou propriedades que podem retornar nulo, você pode usar o operador de coalescência nula.

O exemplo a seguir mostra como o operador de coalescência nula pode ser usado com o IronPDF:

using IronPdf;
using IronPdf.Pages;

namespace ConsoleApp1
{
    internal class Program
    {
        static void Main(string[] args)
        {
            int? x = null;

            // Use the null-coalescing operator to provide a default value if x is null
            var outputstr = $@"square of <b>{x}</b> is <b>{Math.Sqrt(x ?? 30)}</b>";

            // Render the HTML string as a PDF using IronPDF
            var pdfcreate = ChromePdfRenderer.StaticRenderHtmlAsPdf(outputstr);

            // Save the generated PDF to the file system
            pdfcreate.SaveAs("demo.pdf");

            // Wait for a key press to prevent the console from closing immediately
            Console.ReadKey();
        }
    }
}

using IronPdf;
using IronPdf.Pages;

namespace ConsoleApp1
{
    internal class Program
    {
        static void Main(string[] args)
        {
            int? x = null;

            // Use the null-coalescing operator to provide a default value if x is null
            var outputstr = $@"square of <b>{x}</b> is <b>{Math.Sqrt(x ?? 30)}</b>";

            // Render the HTML string as a PDF using IronPDF
            var pdfcreate = ChromePdfRenderer.StaticRenderHtmlAsPdf(outputstr);

            // Save the generated PDF to the file system
            pdfcreate.SaveAs("demo.pdf");

            // Wait for a key press to prevent the console from closing immediately
            Console.ReadKey();
        }
    }
}

Imports IronPdf
Imports IronPdf.Pages

Namespace ConsoleApp1
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			Dim x? As Integer = Nothing

			' Use the null-coalescing operator to provide a default value if x is null
			Dim outputstr = $"square of <b>{x}</b> is <b>{Math.Sqrt(If(x, 30))}</b>"

			' Render the HTML string as a PDF using IronPDF
			Dim pdfcreate = ChromePdfRenderer.StaticRenderHtmlAsPdf(outputstr)

			' Save the generated PDF to the file system
			pdfcreate.SaveAs("demo.pdf")

			' Wait for a key press to prevent the console from closing immediately
			Console.ReadKey()
		End Sub
	End Class
End Namespace

Lembre-se de que o IronPDF (ou qualquer outra biblioteca) não fornece um recurso ou método especial para gerenciar operadores condicionais com valores nulos; Em vez disso, o uso do operador de coalescência nula baseia-se em recursos e conceitos gerais da linguagem C# para lidar com um operador condicional nulo. Para saber mais sobre os recursos e funcionalidades do IronPDF, visite a página de demonstrações do IronPDF .

Saída: