C#에서 선택적 매개변수란 무엇이며 어떻게 사용되나요?

C#의 선택적 매개변수는 개발자가 몇 가지 매개변수에 대해 기본값을 지정함으로써 적은 인수로 호출할 수 있는 메서드를 정의할 수 있도록 합니다. 이는 메서드 호출에서 인수가 생략되면 기본값이 사용됨을 의미합니다.

C#에서 명명된 매개변수가 코드 가독성을 어떻게 향상시킬 수 있나요?

명명된 매개변수는 개발자가 메서드 호출에서 직접 값을 할당하는 매개변수를 지정할 수 있도록 하여 코드 가독성을 향상시킵니다. 이는 특히 매개변수가 여러 개인 메서드를 다룰 때 유용하며, 어떤 인수가 어떤 매개변수에 해당하는지를 명확하게 해줍니다.

C#에서 선택적 매개변수와 메서드 오버로딩의 차이점은 무엇인가요?

선택적 매개변수는 단일 메서드가 다양한 수의 인수를 처리할 수 있도록 하고, 메서드 오버로딩은 다른 매개변수를 가진 여러 버전의 메서드를 생성합니다. 선택적 매개변수는 여러 메서드 정의를 피하여 복잡성을 줄여줍니다.

.NET 라이브러리를 사용하여 PDF를 생성할 때 선택적 매개변수가 어떻게 유용할 수 있나요?

.NET 라이브러리를 사용하여 PDF를 생성할 때 선택적 매개변수는 개발자가 PDF를 생성하기 위해 필요한 인수만 지정할 수 있도록 메서드 호출을 단순화합니다. 이 유연성은 PDF 콘텐츠, 레이아웃 및 파일 속성을 사용자 지정할 때 여러 오버로드가 필요하지 않도록 도와줍니다.

C#에서 선택적 매개변수를 사용할 때의 모범 사례는 무엇인가요?

선택적 매개변수의 모범 사례에는 혼동을 피하기 위해 사용을 제한하고, 기본값을 잘 문서화하며, 메서드 호출의 명확성을 높이기 위해 명명된 매개변수와 함께 사용하는 것이 포함됩니다.

고정 및 선택적 매개변수를 결합하면 메서드 설계에 어떻게 도움이 되나요?

고정 및 선택적 매개변수를 결합하면 개발자가 특정 입력을 필수로 요구하면서 다른 매개변수에 대한 유연성을 제공할 수 있습니다. 이러한 설계 전략은 필수 데이터를 제공하면서 추가적으로 중요하지 않은 입력에 대한 메서드 인터페이스를 단순화합니다.

C#의 선택적 매개변수로 PDF 보고서 생성 과정을 어떻게 단순화할 수 있나요?

C#의 선택적 매개변수는 개발자가 제목이나 저자와 같은 필요한 데이터만 지정할 수 있도록 하여 PDF 보고서 생성 과정을 간소화할 수 있습니다. 기본적으로 설정된 파일 경로나 페이지 레이아웃 등은 기본 설정을 사용하므로 다양한 메서드 버전이 필요하지 않습니다.

What distinguishes method overloading from using optional parameters?

Method overloading involves creating multiple signatures for different use cases, while optional parameters allow a single method to address various scenarios without overloads.

Why is it important to limit the use of optional parameters?

Overusing optional parameters can complicate method signatures and obscure the method's intent, especially when defaults are not clear or intuitive.

How does optional parameter integration improve PDF generation with IronPDF?

By integrating optional parameters, the PDF generation process in IronPDF becomes more adaptable, providing customized document creation that caters to specific reporting needs with minimal changes.

C# PDF 라이브러리

Explore IronPDF 무료 체험 시작하기

HTML을 PDF로 변환

Online Demo 코드 예제 모두 보기

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

PM >Install-Package IronPdf

Install-Package IronPdf

개발자 업데이트

C# 선택적 매개변수 (개발자를 위한 작동 방식)

Jacob Mellor

Updated: 2026년 4월 21일

Defining Optional Parameters in C#

기본 구문

선택적 매개변수를 정의하기 위해 메서드 선언에 기본값을 할당합니다. 이 기본값은 상수 표현식이어야 합니다. 다음은 메소드 정의에서 하나 이상의 선택적 기본 매개변수를 가진 메소드를 정의하는 방법입니다:

public static void DisplayGreeting(string message, string end = "!")
{
    Console.WriteLine(message + end);
}

public static void DisplayGreeting(string message, string end = "!")
{
    Console.WriteLine(message + end);
}

Public Shared Sub DisplayGreeting(ByVal message As String, Optional ByVal [end] As String = "!")
	Console.WriteLine(message & [end])
End Sub

Public Shared Sub DisplayGreeting(ByVal message As String, Optional ByVal [end] As String = "!")
	Console.WriteLine(message & [end])
End Sub

위 코드 스니펫에서 'end'는 '!'의 기본값을 가진 선택적 매개변수입니다. 이는 두 번째 인수를 제공할지 여부에 따라 메소드를 호출할 수 있게 합니다.

선택적 매개변수를 사용한 메서드 호출

다음은 위 메서드를 호출하는 두 가지 방법입니다:

static void Main()
{
    DisplayGreeting("Hello"); // Outputs: Hello!
    DisplayGreeting("Hello", "?"); // Outputs: Hello?
}

static void Main()
{
    DisplayGreeting("Hello"); // Outputs: Hello!
    DisplayGreeting("Hello", "?"); // Outputs: Hello?
}

Shared Sub Main()
	DisplayGreeting("Hello") ' Outputs: Hello!
	DisplayGreeting("Hello", "?") ' Outputs: Hello?
End Sub

Shared Sub Main()
	DisplayGreeting("Hello") ' Outputs: Hello!
	DisplayGreeting("Hello", "?") ' Outputs: Hello?
End Sub

첫 번째 호출은 두 번째 인수를 생략하고 기본값을 사용합니다. 두 번째 호출은 특정 값을 제공하여 기본값을 재정의합니다.

명명된 및 선택적 매개변수 활용

C#의 명명된 및 선택적 매개변수는 선택적 매개변수가 포함된 메소드 호출의 명확성을 높입니다. 호출에서 매개변수를 직접 지정하여 어떤 매개변수에 값을 줄 것인지 지정할 수 있습니다.

명명된 매개변수 사용 예

// Named parameters
public static void ConfigureDevice(string deviceName, bool enableLogging = false, int timeout = 30)
{
    Console.WriteLine($"Configuring {deviceName}: Logging={(enableLogging ? "On" : "Off")}, Timeout={timeout}s");
}

// Named parameters
public static void ConfigureDevice(string deviceName, bool enableLogging = false, int timeout = 30)
{
    Console.WriteLine($"Configuring {deviceName}: Logging={(enableLogging ? "On" : "Off")}, Timeout={timeout}s");
}

' Named parameters
Public Shared Sub ConfigureDevice(ByVal deviceName As String, Optional ByVal enableLogging As Boolean = False, Optional ByVal timeout As Integer = 30)
	Console.WriteLine($"Configuring {deviceName}: Logging={(If(enableLogging, "On", "Off"))}, Timeout={timeout}s")
End Sub

' Named parameters
Public Shared Sub ConfigureDevice(ByVal deviceName As String, Optional ByVal enableLogging As Boolean = False, Optional ByVal timeout As Integer = 30)
	Console.WriteLine($"Configuring {deviceName}: Logging={(If(enableLogging, "On", "Off"))}, Timeout={timeout}s")
End Sub

명명된 매개변수를 사용하여 순서 없이 값을 지정하거나 선택적 매개변수를 건너뛸 수 있습니다.

static void Main()
{
    ConfigureDevice("Router", timeout: 60);
}

static void Main()
{
    ConfigureDevice("Router", timeout: 60);
}

Shared Sub Main()
	ConfigureDevice("Router", timeout:= 60)
End Sub

Shared Sub Main()
	ConfigureDevice("Router", timeout:= 60)
End Sub

이 호출은 enableLogging의 기본값을 사용하면서 시간 제한 값에 대한 선택적 인수를 사용합니다.

고정 및 선택적 매개변수 결합

메소드는 필수 매개변수(고정 인수)와 선택적 매개변수를 모두 가질 수 있습니다. 필수 매개변수는 메서드 선언에서 항상 선택적 매개변수보다 앞에 있어야 하며, 이는 다음 코드 스니펫에서 볼 수 있습니다.

코드 예제

public static void CreateProfile(string firstName, string lastName, int age = 25, string city = "Unknown")
{
    Console.WriteLine($"Name: {firstName} {lastName}, Age: {age}, City: {city}");
}

public static void CreateProfile(string firstName, string lastName, int age = 25, string city = "Unknown")
{
    Console.WriteLine($"Name: {firstName} {lastName}, Age: {age}, City: {city}");
}

Public Shared Sub CreateProfile(ByVal firstName As String, ByVal lastName As String, Optional ByVal age As Integer = 25, Optional ByVal city As String = "Unknown")
	Console.WriteLine($"Name: {firstName} {lastName}, Age: {age}, City: {city}")
End Sub

Public Shared Sub CreateProfile(ByVal firstName As String, ByVal lastName As String, Optional ByVal age As Integer = 25, Optional ByVal city As String = "Unknown")
	Console.WriteLine($"Name: {firstName} {lastName}, Age: {age}, City: {city}")
End Sub

메소드 호출

static void Main()
{
    CreateProfile("John", "Doe"); // Uses default age and city
    CreateProfile("Jane", "Doe", 30, "New York"); // Specifies all parameters
}

static void Main()
{
    CreateProfile("John", "Doe"); // Uses default age and city
    CreateProfile("Jane", "Doe", 30, "New York"); // Specifies all parameters
}

Shared Sub Main()
	CreateProfile("John", "Doe") ' Uses default age and city
	CreateProfile("Jane", "Doe", 30, "New York") ' Specifies all parameters
End Sub

Shared Sub Main()
	CreateProfile("John", "Doe") ' Uses default age and city
	CreateProfile("Jane", "Doe", 30, "New York") ' Specifies all parameters
End Sub

인수를 생략할 수 있는 유연성은 동일한 메소드를 여러 문맥에서 여러 오버로드가 필요 없이 사용할 수 있게 합니다.

기본값은 상수 표현식이어야 함

선택적 인수의 기본 매개변수는 상수 표현식이어야 하며, 이는 컴파일 시에 평가됩니다. 이는 기본값이 언제나 안정적이고 예측 가능하도록 보장합니다.

기본값의 올바른 사용

public static void SendEmail(string address, string subject = "No Subject", string body = "")
{
    Console.WriteLine($"Sending email to {address}\nSubject: {subject}\nBody: {body}");
}

public static void SendEmail(string address, string subject = "No Subject", string body = "")
{
    Console.WriteLine($"Sending email to {address}\nSubject: {subject}\nBody: {body}");
}

Imports Microsoft.VisualBasic

Public Shared Sub SendEmail(ByVal address As String, Optional ByVal subject As String = "No Subject", Optional ByVal body As String = "")
	Console.WriteLine($"Sending email to {address}" & vbLf & "Subject: {subject}" & vbLf & "Body: {body}")
End Sub

Imports Microsoft.VisualBasic

Public Shared Sub SendEmail(ByVal address As String, Optional ByVal subject As String = "No Subject", Optional ByVal body As String = "")
	Console.WriteLine($"Sending email to {address}" & vbLf & "Subject: {subject}" & vbLf & "Body: {body}")
End Sub

오버로딩 vs. 선택적 매개변수

메서드 오버로딩은 다양한 사용 사례를 위해 여러 메서드 서명을 만드는 것이지만, 선택적 매개변수를 사용하면 단일 메서드로 여러 시나리오를 처리할 수 있습니다.

코드를 통한 비교

오버로드된 메소드는 다음과 같을 수 있습니다:

// Method overloading
public static void Alert(string message)
{
    Console.WriteLine(message);
}

public static void Alert(string message, bool urgent)
{
    if (urgent)
        Console.WriteLine("Urgent: " + message);
    else
        Console.WriteLine(message);
}

// Method overloading
public static void Alert(string message)
{
    Console.WriteLine(message);
}

public static void Alert(string message, bool urgent)
{
    if (urgent)
        Console.WriteLine("Urgent: " + message);
    else
        Console.WriteLine(message);
}

' Method overloading
Public Shared Sub Alert(ByVal message As String)
	Console.WriteLine(message)
End Sub

Public Shared Sub Alert(ByVal message As String, ByVal urgent As Boolean)
	If urgent Then
		Console.WriteLine("Urgent: " & message)
	Else
		Console.WriteLine(message)
	End If
End Sub

' Method overloading
Public Shared Sub Alert(ByVal message As String)
	Console.WriteLine(message)
End Sub

Public Shared Sub Alert(ByVal message As String, ByVal urgent As Boolean)
	If urgent Then
		Console.WriteLine("Urgent: " & message)
	Else
		Console.WriteLine(message)
	End If
End Sub

선택적 매개변수를 사용하는 동등한 메서드:

public static void Alert(string message, bool urgent = false)
{
    if (urgent)
        Console.WriteLine("Urgent: " + message);
    else
        Console.WriteLine(message);
}

public static void Alert(string message, bool urgent = false)
{
    if (urgent)
        Console.WriteLine("Urgent: " + message);
    else
        Console.WriteLine(message);
}

Public Shared Sub Alert(ByVal message As String, Optional ByVal urgent As Boolean = False)
	If urgent Then
		Console.WriteLine("Urgent: " & message)
	Else
		Console.WriteLine(message)
	End If
End Sub

Public Shared Sub Alert(ByVal message As String, Optional ByVal urgent As Boolean = False)
	If urgent Then
		Console.WriteLine("Urgent: " & message)
	Else
		Console.WriteLine(message)
	End If
End Sub

C# 선택적 매개변수 (개발자를 위한 작동 방식): 그림 1 - 선택적 매개변수 출력

선택적 매개변수의 장점

선택적 매개변수는 메소드 인터페이스를 단순화하고 수많은 오버로드 필요성을 줄입니다. 이로 인해 메소드는 더 유연해지고, 코드베이스는 유지 관리와 이해가 용이해집니다.

선택적 매개변수의 도전 과제

과도하게 사용하면 선택적 매개변수는 각 메소드가 올바르게 실행되기 위해 어떤 것을 기대하고 요구하는지에 혼동을 초래할 수 있습니다. 매개변수가 많거나 기본값이 자명하지 않을 때는 메소드의 의도를 흐리게 만들 수 있습니다.

모범 사례

선택적 매개변수 제한: 지나치게 복잡한 메서드 시그니처를 피하기 위해 선택적 매개변수를 신중히 사용하십시오.
명명된 인수 사용: 특정 선택적 매개변수를 건너뛸 때 메소드 호출의 명확성을 개선하십시오.
기본값 문서화: 각 매개변수가 무엇을 하고 기본값이 무엇을 의미하는지 문서화하여 오용이나 혼동을 방지하십시오.

C# 선택적 매개변수를 활용한 IronPDF

C# 선택적 매개변수 (개발자를 위한 작동 방식): 그림 2 - IronPDF

IronPDF는 개발자가 응용 프로그램 내에서 PDF 문서를 직접 생성, 조작 및 렌더링할 수 있게 해주는 유용한 .NET 라이브러리입니다. HTML을 PDF로 효율적으로 변환하여 PDF 변환을 처리합니다. 이 HTML은 HTML 문자열, HTML 파일 또는 URL과 같은 다양한 형태로 있을 수 있습니다. 이는 송장, 보고서 또는 사용자 맞춤형 콘텐츠와 같은 동적 PDF 문서 생성을 필요로 하는 응용 프로그램에 이상적입니다. IronPDF를 사용하여 개발자는 PDF 파일을 효율적으로 처리하기 위해 .NET Framework를 완전하게 활용할 수 있습니다.

IronPDF의 뛰어난 기능은 HTML을 PDF로 쉽게 변환할 수 있는 능력으로, 레이아웃과 스타일을 유지합니다. 웹 기반 콘텐츠에서 보고서, 송장 또는 문서와 같은 PDF를 생성하는 데 완벽합니다. HTML 파일, URL 및 HTML 문자열을 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

Module Program
    Sub Main(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 Module

Imports IronPdf

Module Program
    Sub Main(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 Module

IronPDF와 C#의 선택적 매개변수를 결합하면 PDF 문서 생성 프로세스를 쉽게 만들 수 있습니다. 선택적 매개변수를 사용하면 개발자는 최소한의 메서드 오버로드로 다양한 입력과 요구 사항에 적응할 수 있는 유연한 PDF 생성 방법을 만들 수 있습니다.

코드 예제

IronPDF와 C# 선택적 매개변수를 함께 사용하여 간단한 HTML 템플릿에서 맞춤형 PDF 보고서를 생성하고 제목이나 특정 보고서 섹션 포함 여부와 같은 세부 정보를 잠재적으로 조정하는 방법을 보여주는 예시입니다:

using IronPdf;
using System;

public class PdfReportGenerator
{
    // Method to generate PDF with optional parameters
    public static void CreatePdfReport(string htmlContent, string filePath = "Report.pdf", bool includeCharts = true, string reportTitle = "Monthly Report")
    {
        // Optional parameters allow customization of the report's title and content dynamically
        var renderer = new ChromePdfRenderer();
        // Customize the PDF document
        renderer.RenderingOptions.TextHeader.CenterText = reportTitle;
        renderer.RenderingOptions.TextFooter.CenterText = "Generated on " + DateTime.Now.ToString("dd-MM-yyyy");
        renderer.RenderingOptions.MarginTop = 50;  // Set the top margin
        renderer.RenderingOptions.MarginBottom = 50;  // Set the bottom margin
        if (!includeCharts)
        {
            // Modify HTML content to remove chart sections if not included
            htmlContent = htmlContent.Replace("<div class='charts'></div>", "");
        }
        // Render the HTML to PDF
        PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);
        // Save the generated PDF to a file
        pdf.SaveAs(filePath);
        Console.WriteLine($"PDF report has been created at {filePath}");
    }

    static void Main()
    {
        License.LicenseKey = "License-Key"; // Specify the license key if required
        string htmlTemplate = @"
        <html>
        <head>
            <title>Monthly Report</title>
        </head>
        <body>
            <h1>Monthly Performance Report</h1>
            <p>This section contains text describing the overall performance for the month.</p>
            <div class='charts'>
                <h2>Sales Charts</h2>
                <!-- Placeholder for charts -->
            </div>
        </body>
        </html>";

        // Call the CreatePdfReport method with different parameters
        CreatePdfReport(htmlTemplate, "BasicReport.pdf", false, "Basic Monthly Report");
        CreatePdfReport(htmlTemplate, "FullReport.pdf", true, "Detailed Monthly Report");
    }
}

using IronPdf;
using System;

public class PdfReportGenerator
{
    // Method to generate PDF with optional parameters
    public static void CreatePdfReport(string htmlContent, string filePath = "Report.pdf", bool includeCharts = true, string reportTitle = "Monthly Report")
    {
        // Optional parameters allow customization of the report's title and content dynamically
        var renderer = new ChromePdfRenderer();
        // Customize the PDF document
        renderer.RenderingOptions.TextHeader.CenterText = reportTitle;
        renderer.RenderingOptions.TextFooter.CenterText = "Generated on " + DateTime.Now.ToString("dd-MM-yyyy");
        renderer.RenderingOptions.MarginTop = 50;  // Set the top margin
        renderer.RenderingOptions.MarginBottom = 50;  // Set the bottom margin
        if (!includeCharts)
        {
            // Modify HTML content to remove chart sections if not included
            htmlContent = htmlContent.Replace("<div class='charts'></div>", "");
        }
        // Render the HTML to PDF
        PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);
        // Save the generated PDF to a file
        pdf.SaveAs(filePath);
        Console.WriteLine($"PDF report has been created at {filePath}");
    }

    static void Main()
    {
        License.LicenseKey = "License-Key"; // Specify the license key if required
        string htmlTemplate = @"
        <html>
        <head>
            <title>Monthly Report</title>
        </head>
        <body>
            <h1>Monthly Performance Report</h1>
            <p>This section contains text describing the overall performance for the month.</p>
            <div class='charts'>
                <h2>Sales Charts</h2>
                <!-- Placeholder for charts -->
            </div>
        </body>
        </html>";

        // Call the CreatePdfReport method with different parameters
        CreatePdfReport(htmlTemplate, "BasicReport.pdf", false, "Basic Monthly Report");
        CreatePdfReport(htmlTemplate, "FullReport.pdf", true, "Detailed Monthly Report");
    }
}

Imports IronPdf
Imports System

Public Class PdfReportGenerator
	' Method to generate PDF with optional parameters
	Public Shared Sub CreatePdfReport(ByVal htmlContent As String, Optional ByVal filePath As String = "Report.pdf", Optional ByVal includeCharts As Boolean = True, Optional ByVal reportTitle As String = "Monthly Report")
		' Optional parameters allow customization of the report's title and content dynamically
		Dim renderer = New ChromePdfRenderer()
		' Customize the PDF document
		renderer.RenderingOptions.TextHeader.CenterText = reportTitle
		renderer.RenderingOptions.TextFooter.CenterText = "Generated on " & DateTime.Now.ToString("dd-MM-yyyy")
		renderer.RenderingOptions.MarginTop = 50 ' Set the top margin
		renderer.RenderingOptions.MarginBottom = 50 ' Set the bottom margin
		If Not includeCharts Then
			' Modify HTML content to remove chart sections if not included
			htmlContent = htmlContent.Replace("<div class='charts'></div>", "")
		End If
		' Render the HTML to PDF
		Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlContent)
		' Save the generated PDF to a file
		pdf.SaveAs(filePath)
		Console.WriteLine($"PDF report has been created at {filePath}")
	End Sub

	Shared Sub Main()
		License.LicenseKey = "License-Key" ' Specify the license key if required
		Dim htmlTemplate As String = "
        <html>
        <head>
            <title>Monthly Report</title>
        </head>
        <body>
            <h1>Monthly Performance Report</h1>
            <p>This section contains text describing the overall performance for the month.</p>
            <div class='charts'>
                <h2>Sales Charts</h2>
                <!-- Placeholder for charts -->
            </div>
        </body>
        </html>"

		' Call the CreatePdfReport method with different parameters
		CreatePdfReport(htmlTemplate, "BasicReport.pdf", False, "Basic Monthly Report")
		CreatePdfReport(htmlTemplate, "FullReport.pdf", True, "Detailed Monthly Report")
	End Sub
End Class

Imports IronPdf
Imports System

Public Class PdfReportGenerator
	' Method to generate PDF with optional parameters
	Public Shared Sub CreatePdfReport(ByVal htmlContent As String, Optional ByVal filePath As String = "Report.pdf", Optional ByVal includeCharts As Boolean = True, Optional ByVal reportTitle As String = "Monthly Report")
		' Optional parameters allow customization of the report's title and content dynamically
		Dim renderer = New ChromePdfRenderer()
		' Customize the PDF document
		renderer.RenderingOptions.TextHeader.CenterText = reportTitle
		renderer.RenderingOptions.TextFooter.CenterText = "Generated on " & DateTime.Now.ToString("dd-MM-yyyy")
		renderer.RenderingOptions.MarginTop = 50 ' Set the top margin
		renderer.RenderingOptions.MarginBottom = 50 ' Set the bottom margin
		If Not includeCharts Then
			' Modify HTML content to remove chart sections if not included
			htmlContent = htmlContent.Replace("<div class='charts'></div>", "")
		End If
		' Render the HTML to PDF
		Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlContent)
		' Save the generated PDF to a file
		pdf.SaveAs(filePath)
		Console.WriteLine($"PDF report has been created at {filePath}")
	End Sub

	Shared Sub Main()
		License.LicenseKey = "License-Key" ' Specify the license key if required
		Dim htmlTemplate As String = "
        <html>
        <head>
            <title>Monthly Report</title>
        </head>
        <body>
            <h1>Monthly Performance Report</h1>
            <p>This section contains text describing the overall performance for the month.</p>
            <div class='charts'>
                <h2>Sales Charts</h2>
                <!-- Placeholder for charts -->
            </div>
        </body>
        </html>"

		' Call the CreatePdfReport method with different parameters
		CreatePdfReport(htmlTemplate, "BasicReport.pdf", False, "Basic Monthly Report")
		CreatePdfReport(htmlTemplate, "FullReport.pdf", True, "Detailed Monthly Report")
	End Sub
End Class

여기 FullReport PDF 파일 미리보기입니다:

C# 선택적 매개변수 (개발자를 위한 작동 방식): 그림 3 - PDF 보고서 출력

코드 예시의 CreatePdfReport 메서드는 파일 경로, 차트 포함, 보고서 제목과 같은 선택적 매개변수를 통해 HTML 콘텐츠로부터 PDF 문서를 생성하도록 구조화되었습니다. 이 설계는 코드의 사소한 조정으로 다양한 보고 요구 사항에 적응할 수 있도록 합니다. 메서드 내에서 IronPDF 설정은 PDF에 사용자 지정 헤더와 푸터를 포함하도록 조정되며, 이는 보고서 제목과 보고서 생성 날짜를 표시하도록 설정됩니다.

문서의 시각적 레이아웃을 개선하기 위해 여백도 구성됩니다. includeCharts 매개변수가 true나 false인지에 따라 HTML 콘텐츠는 차트 비주얼을 포함하거나 제외하도록 동적으로 수정됩니다. 잠재적으로 수정된 HTML을 PDF로 변환하고 지정된 위치에 저장합니다. 이 예시는 선택적 매개변수가 맞춤형 PDF 보고서 생성 프로세스를 어떻게 크게 단순화할 수 있는지 보여줍니다.

결론

결론적으로, 선택적 매개변수를 사용하면 여러 오버로드된 메서드를 줄여 더 유연하고 유지보수하기 쉬운 코드를 생성할 수 있습니다. C# 선택적 매개변수와 IronPDF 라이브러리를 결합하면 개발자는 맞춤형 PDF 문서를 효율적으로 생성할 수 있습니다. 이 통합은 코드베이스를 단순화할 뿐만 아니라 기능성을 향상하여 서로 다른 보고 요구 사항이나 사용자 선호도에 쉽게 적응할 수 있게 합니다.

IronPDF 자체는 PDF 기능을 응용 프로그램에 통합하고자 하는 모든 .NET 개발자에게 강력한 도구로, 개발자를 위한 무료 IronPDF 체험판을 제공하여 그 기능을 테스트해볼 수 있습니다. 지속적인 사용을 위해 라이선스는 $999에서 시작하며, 전문가 수준의 PDF 조작에 비용 효율적인 솔루션을 제공합니다.

Jacob Mellor

지금 바로 엔지니어링 팀과 채팅하세요

최고기술책임자

제이콥 멜러는 Iron Software의 최고 기술 책임자(CTO)이자 C# PDF 기술을 개척한 선구적인 엔지니어입니다. Iron Software의 핵심 코드베이스를 최초로 개발한 그는 창립 초기부터 회사의 제품 아키텍처를 설계해 왔으며, CEO인 캐머런 리밍턴과 함께 회사를 NASA, 테슬라, 그리고 전 세계 정부 기관에 서비스를 제공하는 50명 이상의 직원을 보유한 기업으로 성장시켰습니다.

...

더 읽어보기