Parametry domyślne w języku C# (jak to działa dla programistów)

Czym są parametry domyślne?

W języku C# parametry domyślne, znane również jako parametry opcjonalne, pozwalają przypisać wartość do stałych argumentów w definicji metody. Jeśli podczas wywołania funkcji nie zostanie podany argument dla tego parametru, zostanie użyta wartość domyślna.

W definicji metody ustawiono domyślną wartość parametru, jak pokazano w poniższym fragmencie kodu:

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

W tym przypadku parametr name jest atrybutem opcjonalnym. Ciąg znaków "Friend" jest wartością domyślną. Jeśli wywołasz Greet() bez przekazania argumentu, jako wartość dla name zostanie użyte słowo "Friend".

Parametry wymagane i parametry opcjonalne

// 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

Zasady korzystania z parametrów domyślnych

Podczas definiowania metody z parametrami domyślnymi należy pamiętać o kilku kluczowych zasadach:

1. Wartość domyślna musi być wyrażeniem stałym. Nie można używać zmiennych ani wywołań metod.
2. Wszystkie parametry opcjonalne muszą być zdefiniowane na końcu listy parametrów, po wszystkich wymaganych parametrach.
3. Wywołując metodę z parametrami opcjonalnymi, można podać pominięte argumenty dla parametrów opcjonalnych w kolejności, w jakiej zostały zdefiniowane, lub użyć argumentów nazwanych.
4. Jeśli nie podano wartości argumentu opcjonalnego, zostanie użyta wartość domyślna.

Rozważmy następujący fragment kodu dotyczący argumentów opcjonalnych:

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

W metodzie Main wywołujemy ShowMessage dwukrotnie. Za pierwszym razem przekazujemy tylko jeden argument, więc parametr name przyjmuje wartość domyślną "Friend". Za drugim razem przekazujemy dwa argumenty, więc zamiast wartości domyślnej używamy "John".

Parametry nazwane i opcjonalne

C# obsługuje również parametry nazwane i opcjonalne. Parametry nazwane pozwalają określić wartość parametru na podstawie nazwy, a nie pozycji. Może to być pomocne, gdy metoda ma kilka opcjonalnych parametrów, a chcesz podać wartość dla jednego z nich, ale nie dla pozostałych.

W poniższym przykładzie ShowGreetings ma dwa opcjonalne parametry:

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

Możemy wywołać tę metodę, podając tylko pierwszy parametr:

ShowGreetings("Hi");

ShowGreetings("Hi");

ShowGreetings("Hi")

Możemy też użyć argumentów nazwanych, aby podać wartość dla name, pomijając argument 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)

Parametry domyślne i przeciążanie metod

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")

Pakiet oprogramowania Iron Suite

Przyjrzyjmy się pakietowi Iron Software, który obejmuje bibliotekę IronPDF do obsługi plików PDF, bibliotekę IronXL do operacji w Excelu w języku C#, IronOCR do zaawansowanego rozpoznawania tekstu oraz IronBarcode do generowania kodów kreskowych. Te potężne biblioteki zostały zaprojektowane specjalnie po to, by pomóc Ci rozszerzyć możliwości Twoich aplikacji napisanych w języku C#. Można je łatwo powiązać z koncepcjami omówionymi w artykule, w tym parametrami domyślnymi, specyfikacjami nazwanych argumentów i przeciążaniem metod.

IronPDF: Jest to biblioteka C# służąca do konwersji HTML do formatu PDF za pomocą IronPDF. Zrozumienie parametrów domyślnych i opcjonalnych może mieć kluczowe znaczenie podczas korzystania z IronPDF. Wiele metod w IronPDF będzie miało parametry opcjonalne, co pozwala na szerokie dostosowanie bez nadmiernego komplikowania sygnatur metod. Więcej informacji na ten temat można znaleźć w samouczku IronPDF dotyczącym konwersji HTML do 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");
    }
}

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

Biblioteka IronXL umożliwia aplikacji napisanej w języku C# odczytywanie, zapisywanie i przetwarzanie plików Excel w różnych formatach. Metody w IronXL mogą mieć różne parametry dotyczące takich kwestii, jak format zapisu pliku lub to, czy podczas importowania danych należy uwzględniać nagłówki. Można również zauważyć, że parametry nazwane i opcjonalne są szeroko stosowane do określania zakresów komórek, opcji formatowania i innych elementów.
IronOCR: zaawansowana biblioteka optycznego rozpoznawania znaków (OCR), która umożliwia odczytywanie tekstu i kodów kreskowych z obrazów i plików PDF w aplikacjach napisanych w języku C#. Metody IronOCR mogą posiadać opcjonalne parametry służące do kontrolowania różnych aspektów procesu OCR, takich jak język tekstu, poziom korekty błędów itp. Zrozumienie tych parametrów pozwala na lepszą kontrolę nad procesem OCR.
Biblioteka IronBarcode jest wszechstronnym narzędziem do odczytu i generowania kodów kreskowych w aplikacjach .NET. Również w tym przypadku kluczowe znaczenie ma zrozumienie parametrów domyślnych. Na przykład podczas generowania kodu kreskowego mogą być dostępne opcjonalne parametry pozwalające określić rozmiar, format lub wartość kodu kreskowego.

Wnioski

Podsumowując, opanowanie użycia parametrów domyślnych i opcjonalnych w języku C# może znacznie zwiększyć wydajność programowania i wszechstronność kodu. Te pojęcia są fundamentalne dla języka C#.

Mówiąc o tych bibliotekach, należy pamiętać, że ceny poszczególnych licencji zaczynają się od $799, a biblioteki te oferują również bezpłatną wersję próbną produktów Iron Software. Jednak firma Iron Software oferuje pakiet: można nabyć cały zestaw za cenę zaledwie dwóch pojedynczych licencji.