Parâmetros padrão em C# (Como funciona para desenvolvedores)

O que são parâmetros padrão?

Em C#, os parâmetros padrão , também conhecidos como parâmetros de argumento opcionais, permitem atribuir um valor a argumentos fixos na definição de um método. Se nenhum argumento para esse parâmetro for fornecido quando a função for chamada, será utilizado o valor padrão.

Um valor de parâmetro padrão é definido na definição do método, conforme mostrado no trecho de código abaixo:

public void Greet(string name = "Friend")
{
    Console.WriteLine("Hello, " + name);
}

public void Greet(string name = "Friend")
{
    Console.WriteLine("Hello, " + name);
}

Public Sub Greet(Optional ByVal name As String = "Friend")
	Console.WriteLine("Hello, " & name)
End Sub

Aqui, o parâmetro name é um atributo opcional. A string "Friend" é o valor padrão. Se você chamar Greet() sem passar um argumento, "Friend" será usado como o valor para name.

Parâmetros obrigatórios e parâmetros opcionais

// Method with required parameters
public void IntroduceYourself(string firstName, string lastName)
{
    Console.WriteLine("Hello, my name is " + firstName + " " + lastName);
}

// Method with required parameters
public void IntroduceYourself(string firstName, string lastName)
{
    Console.WriteLine("Hello, my name is " + firstName + " " + lastName);
}

' Method with required parameters
Public Sub IntroduceYourself(ByVal firstName As String, ByVal lastName As String)
	Console.WriteLine("Hello, my name is " & firstName & " " & lastName)
End Sub

IntroduceYourself("John", "Doe"); // Following call is correct
// IntroduceYourself("John"); // Error: lastName is missing

IntroduceYourself("John", "Doe"); // Following call is correct
// IntroduceYourself("John"); // Error: lastName is missing

IntroduceYourself("John", "Doe") ' Following call is correct
' IntroduceYourself("John"); // Error: lastName is missing

// Method with an optional parameter
public void IntroduceYourself(string firstName, string lastName = "Doe")
{
    Console.WriteLine("Hello, my name is " + firstName + " " + lastName);
}

// Method with an optional parameter
public void IntroduceYourself(string firstName, string lastName = "Doe")
{
    Console.WriteLine("Hello, my name is " + firstName + " " + lastName);
}

' Method with an optional parameter
Public Sub IntroduceYourself(ByVal firstName As String, Optional ByVal lastName As String = "Doe")
	Console.WriteLine("Hello, my name is " & firstName & " " & lastName)
End Sub

IntroduceYourself("John", "Smith"); // Outputs: Hello, my name is John Smith
IntroduceYourself("John");          // Outputs: Hello, my name is John Doe

IntroduceYourself("John", "Smith"); // Outputs: Hello, my name is John Smith
IntroduceYourself("John");          // Outputs: Hello, my name is John Doe

IntroduceYourself("John", "Smith") ' Outputs: Hello, my name is John Smith
IntroduceYourself("John") ' Outputs: Hello, my name is John Doe

Regras para usar parâmetros padrão

Ao definir um método com parâmetros padrão, há algumas regras importantes a serem lembradas:

1. O valor padrão deve ser uma expressão constante. Não é possível usar variáveis ​​ou chamadas de método.
2. Todos os parâmetros opcionais devem ser definidos no final da lista de parâmetros, após quaisquer parâmetros obrigatórios.
3. Ao chamar um método com parâmetros opcionais, você pode fornecer argumentos omitidos para os parâmetros opcionais na ordem em que são definidos, ou pode usar argumentos nomeados.
4. O valor padrão será usado se nenhum valor de argumento opcional for fornecido.

Considere o seguinte trecho de código para argumentos opcionais:

static void Main(string[] args)
{
    ShowMessage("Hello");
    ShowMessage("Hello", "John");
}

public static void ShowMessage(string msg, string name = "Friend")
{
    Console.WriteLine(msg + ", " + name);
}

static void Main(string[] args)
{
    ShowMessage("Hello");
    ShowMessage("Hello", "John");
}

public static void ShowMessage(string msg, string name = "Friend")
{
    Console.WriteLine(msg + ", " + name);
}

Shared Sub Main(ByVal args() As String)
	ShowMessage("Hello")
	ShowMessage("Hello", "John")
End Sub

Public Shared Sub ShowMessage(ByVal msg As String, Optional ByVal name As String = "Friend")
	Console.WriteLine(msg & ", " & name)
End Sub

No método Main, chamamos ShowMessage duas vezes. Na primeira vez, passamos apenas um argumento, portanto, o parâmetro name usa seu valor padrão "Friend". Na segunda vez, passamos dois argumentos, então "John" é usado em vez do valor padrão.

Parâmetros nomeados e opcionais

O C# também suporta parâmetros nomeados e opcionais. Os parâmetros nomeados permitem especificar um valor para um parâmetro pelo nome, em vez de pela posição. Isso pode ser útil quando um método possui vários parâmetros opcionais e você deseja fornecer um valor para um deles, mas não para os outros.

No exemplo a seguir, ShowGreetings possui dois parâmetros opcionais:

public static void ShowGreetings(string greeting = "Hello", string name = "Friend")
{
    Console.WriteLine(greeting + ", " + name);
}

public static void ShowGreetings(string greeting = "Hello", string name = "Friend")
{
    Console.WriteLine(greeting + ", " + name);
}

Public Shared Sub ShowGreetings(Optional ByVal greeting As String = "Hello", Optional ByVal name As String = "Friend")
	Console.WriteLine(greeting & ", " & name)
End Sub

Podemos chamar esse método apenas com o primeiro parâmetro:

ShowGreetings("Hi");

ShowGreetings("Hi");

ShowGreetings("Hi")

Ou podemos usar argumentos nomeados para fornecer um valor para o argumento name, omitindo o argumento greeting:

ShowGreetings(name: "John");

ShowGreetings(name: "John");

ShowGreetings(name:= "John")

// Method Declaration
public void RegisterUser(string username, string password, string email = "", bool subscribeToNewsletter = false)
{
    // Method body
}

// Method Call
RegisterUser(username: "JohnDoe", password: "password123", subscribeToNewsletter: true);

// Method Declaration
public void RegisterUser(string username, string password, string email = "", bool subscribeToNewsletter = false)
{
    // Method body
}

// Method Call
RegisterUser(username: "JohnDoe", password: "password123", subscribeToNewsletter: true);

' Method Declaration
Public Sub RegisterUser(ByVal username As String, ByVal password As String, Optional ByVal email As String = "", Optional ByVal subscribeToNewsletter As Boolean = False)
	' Method body
End Sub

' Method Call
RegisterUser(username:= "JohnDoe", password:= "password123", subscribeToNewsletter:= True)

Parâmetros padrão e sobrecarga de métodos

public void DisplayMessage(string message)
{
    Console.WriteLine(message);
}

public void DisplayMessage(string message, string name)
{
    Console.WriteLine(message + ", " + name);
}

public void DisplayMessage(string message)
{
    Console.WriteLine(message);
}

public void DisplayMessage(string message, string name)
{
    Console.WriteLine(message + ", " + name);
}

Public Sub DisplayMessage(ByVal message As String)
	Console.WriteLine(message)
End Sub

Public Sub DisplayMessage(ByVal message As String, ByVal name As String)
	Console.WriteLine(message & ", " & name)
End Sub

public void DisplayMessage(string message, string name = "Friend")
{
    Console.WriteLine(message + ", " + name);
}

public void DisplayMessage(string message, string name = "Friend")
{
    Console.WriteLine(message + ", " + name);
}

Public Sub DisplayMessage(ByVal message As String, Optional ByVal name As String = "Friend")
	Console.WriteLine(message & ", " & name)
End Sub

DisplayMessage("Hello");
DisplayMessage("Hello", "John");

DisplayMessage("Hello");
DisplayMessage("Hello", "John");

DisplayMessage("Hello")
DisplayMessage("Hello", "John")

Pacote de Iron Software

Vamos explorar o pacote Iron Software , que inclui a biblioteca IronPDF para soluções em PDF , o IronXL para operações em C# com o Excel , o IronOCR para reconhecimento avançado de texto e o IronBarcode para geração de códigos de barras . Essas poderosas bibliotecas foram projetadas especificamente para ajudar você a expandir os recursos de seus aplicativos C#. Eles podem ser facilmente relacionados aos conceitos que discutimos no artigo, incluindo parâmetros padrão, especificações de argumentos nomeados e sobrecarga de métodos.

IronPDF: Esta é uma biblioteca C# para converter HTML em PDF com o IronPDF . Compreender os parâmetros padrão e opcionais pode ser crucial ao usar o IronPDF. Muitos dos métodos em IronPDF possuem parâmetros opcionais, o que permite uma ampla personalização sem complicar excessivamente as assinaturas dos métodos. Você pode encontrar mais informações sobre isso no tutorial de conversão de HTML para PDF do IronPDF .

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

Imports IronPdf

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()

		' 1. Convert HTML String to PDF
		Dim htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>"
		Dim pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent)
		pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf")

		' 2. Convert HTML File to PDF
		Dim htmlFilePath = "path_to_your_html_file.html" ' Specify the path to your HTML file
		Dim pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath)
		pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf")

		' 3. Convert URL to PDF
		Dim url = "http://ironpdf.com" ' Specify the URL
		Dim pdfFromUrl = renderer.RenderUrlAsPdf(url)
		pdfFromUrl.SaveAs("URLToPDF.pdf")
	End Sub
End Class

IronXL: Esta biblioteca permite que sua aplicação C# leia, grave e manipule arquivos Excel em diversos formatos. Os métodos no IronXL podem ter parâmetros diferentes para coisas como o formato em que um arquivo será salvo ou se os cabeçalhos devem ser incluídos ao importar dados. Você também poderá constatar que parâmetros nomeados e opcionais são amplamente utilizados para especificar intervalos de células, opções de formatação e muito mais.
IronOCR: Uma biblioteca avançada de Reconhecimento Óptico de Caracteres (OCR) capaz de ler textos e códigos de barras em imagens e PDFs em suas aplicações C#. Os métodos do IronOCR podem ter parâmetros opcionais para controlar aspectos do processo de OCR, como o idioma do texto, o nível de correção de erros a ser aplicado e assim por diante. Compreender esses parâmetros pode lhe dar um melhor controle sobre o processo de OCR.
IronBarcode: Esta biblioteca é uma ferramenta versátil para leitura e geração de códigos de barras em aplicações .NET . Aqui também, compreender os parâmetros padrão é crucial. Ao gerar um código de barras, por exemplo, você pode ter parâmetros opcionais para especificar o tamanho, o formato ou o valor do código de barras.

Conclusão

Em conclusão, dominar o uso de parâmetros padrão e opcionais em C# pode melhorar significativamente a eficiência da sua programação e a versatilidade do seu código. Esses conceitos são fundamentais para o C#.

Falando dessas bibliotecas, lembre-se de que as licenças individuais para cada uma começam em $799, e essas bibliotecas também oferecem um teste gratuito dos produtos da Iron Software . No entanto, a Iron Software oferece um pacote promocional: você pode adquirir o pacote completo pelo preço de apenas duas licenças individuais.