1단계: C# PDF 생성을 위한 Visual Studio 프로젝트 설정하기

가장 첫 번째 단계는 Visual Studio 프로젝트를 생성하는 것입니다. 이 튜토리얼에서는 Windows Forms App 템플릿을 사용하지만, IronPDF는 웹 애플리케이션(ASP.NET), 콘솔 앱, WPF 등과 원활하게 작동합니다.

Visual Studio를 엽니다.

"새 프로젝트 만들기"를 클릭합니다.

템플릿에서 'Windows Forms App (.NET Framework 또는 .NET Core)'을 선택한 후 '다음'을 클릭합니다. 다음 창이 나타납니다. 프로젝트 이름 지정 (예: MyCSharpPdfGenerator).

프로젝트 이름 지정하기

그런 다음 '다음'을 클릭합니다. 드롭다운 메뉴에서 원하는 .NET Framework를 선택합니다(IronPDF는 다양한 범위를 지원합니다).

.NET Framework 선택하기

'생성' 버튼을 클릭합니다. 프로젝트가 생성되며 다음 단계를 준비합니다.

2단계: IronPDF C# 라이브러리 설치 - PDF 생성의 핵심

IronPDF는 NuGet을 통해 쉽게 프로젝트에 추가할 수 있습니다. 이 방법은 최신 버전과 모든 필수 종속성을 확보하는 데 권장됩니다.

Install-Package IronPdf

3단계: 간단한 Windows Form 인터페이스 디자인(선택 사항)

이 튜토리얼에서는 PDF 생성을 트리거하는 기본 UI를 생성합니다. 웹 또는 콘솔 애플리케이션을 빌드하는 경우 IronPDF 로직을 컨트롤러, 서비스, 클래스에 직접 통합합니다.

Visual Studio의 ToolBox로 이동합니다(보기 > ToolBox). 다음 컨트롤을 Form1 디자인 표면에 드래그 앤 드롭합니다:

• 하나의 Label (예: 응용 프로그램의 제목을 'C# PDF Generator Demo'로 지정하기).
• HTML/텍스트 입력을 위한 RichTextBox (이름을 PdfText으로 지정).
• URL 입력을 위한 TextBox (이름을 URL으로 지정).

• 두 개의 Button 컨트롤.

  • 첫 번째 버튼의 텍스트를 'Generate PDF From Text'로 설정 (이름은 GeneratePDFFromTextButton).
  • 두 번째 버튼의 텍스트를 'Generate PDF From URL'로 설정 (이름은 GeneratePDFFromURLButton).

4단계: 텍스트/HTML에서 PDF를 생성하는 C# 코드 작성

이제 C# 로직을 추가해 보겠습니다. 폼 디자이너에서 'Generate PDF From Text' 버튼 (GeneratePDFFromTextButton)을 더블 클릭합니다. 이렇게 하면 Form1.cs 파일에 이벤트 핸들러 메서드가 생성됩니다.

먼저 Form1.cs 파일 상단에 IronPDF 네임스페이스를 추가하십시오:

using IronPdf;

using IronPdf;

Imports IronPdf

그런 다음 버튼의 click 이벤트 핸들러를 구현합니다. 이 코드는 RichTextBox에서 텍스트(일반 텍스트 또는 HTML일 수 있음)를 가져와 PDF 문서로 변환합니다.

private void GeneratePDFFromTextButton_Click(object sender, EventArgs e)
{
    // It's recommended to set your license key once at application startup.
    // IronPdf.License.LicenseKey = "YourLicenseKey-GetYourKeyFromIronPdf.com"; 
    // If no key is set, IronPDF will watermark PDFs after a trial period.

    // Use SaveFileDialog to let the user choose where to save the PDF
    SaveFileDialog saveFileDialog1 = new SaveFileDialog();
    saveFileDialog1.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments); // Default to My Documents
    saveFileDialog1.Title = "Save PDF File As";
    saveFileDialog1.DefaultExt = "pdf";
    saveFileDialog1.Filter = "PDF files (*.pdf)|*.pdf|All files (*.*)|*.*";
    saveFileDialog1.FilterIndex = 1; // Start with PDF files selected
    saveFileDialog1.RestoreDirectory = true;

    if (saveFileDialog1.ShowDialog() == DialogResult.OK)
    {
        string filename = saveFileDialog1.FileName;

        // The core of PDF generation from HTML/Text using IronPDF
        // IronPDF's ChromePdfRenderer accurately renders HTML, CSS, and JavaScript.
        var renderer = new ChromePdfRenderer();

        // The RenderHtmlAsPdf method converts an HTML string to a PDF document.
        // This is incredibly powerful for generating dynamic reports, invoices, tickets, etc.
        // from HTML templates.
        using (var pdfDocument = renderer.RenderHtmlAsPdf(PdfText.Text))
        {
            pdfDocument.SaveAs(filename);
        }

        MessageBox.Show("PDF Generated Successfully at: " + filename, "Success", MessageBoxButtons.OK, MessageBoxIcon.Information);
    }
}

private void GeneratePDFFromTextButton_Click(object sender, EventArgs e)
{
    // It's recommended to set your license key once at application startup.
    // IronPdf.License.LicenseKey = "YourLicenseKey-GetYourKeyFromIronPdf.com"; 
    // If no key is set, IronPDF will watermark PDFs after a trial period.

    // Use SaveFileDialog to let the user choose where to save the PDF
    SaveFileDialog saveFileDialog1 = new SaveFileDialog();
    saveFileDialog1.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments); // Default to My Documents
    saveFileDialog1.Title = "Save PDF File As";
    saveFileDialog1.DefaultExt = "pdf";
    saveFileDialog1.Filter = "PDF files (*.pdf)|*.pdf|All files (*.*)|*.*";
    saveFileDialog1.FilterIndex = 1; // Start with PDF files selected
    saveFileDialog1.RestoreDirectory = true;

    if (saveFileDialog1.ShowDialog() == DialogResult.OK)
    {
        string filename = saveFileDialog1.FileName;

        // The core of PDF generation from HTML/Text using IronPDF
        // IronPDF's ChromePdfRenderer accurately renders HTML, CSS, and JavaScript.
        var renderer = new ChromePdfRenderer();

        // The RenderHtmlAsPdf method converts an HTML string to a PDF document.
        // This is incredibly powerful for generating dynamic reports, invoices, tickets, etc.
        // from HTML templates.
        using (var pdfDocument = renderer.RenderHtmlAsPdf(PdfText.Text))
        {
            pdfDocument.SaveAs(filename);
        }

        MessageBox.Show("PDF Generated Successfully at: " + filename, "Success", MessageBoxButtons.OK, MessageBoxIcon.Information);
    }
}

Private Sub GeneratePDFFromTextButton_Click(ByVal sender As Object, ByVal e As EventArgs)
	' It's recommended to set your license key once at application startup.
	' IronPdf.License.LicenseKey = "YourLicenseKey-GetYourKeyFromIronPdf.com"; 
	' If no key is set, IronPDF will watermark PDFs after a trial period.

	' Use SaveFileDialog to let the user choose where to save the PDF
	Dim saveFileDialog1 As New SaveFileDialog()
	saveFileDialog1.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments) ' Default to My Documents
	saveFileDialog1.Title = "Save PDF File As"
	saveFileDialog1.DefaultExt = "pdf"
	saveFileDialog1.Filter = "PDF files (*.pdf)|*.pdf|All files (*.*)|*.*"
	saveFileDialog1.FilterIndex = 1 ' Start with PDF files selected
	saveFileDialog1.RestoreDirectory = True

	If saveFileDialog1.ShowDialog() = DialogResult.OK Then
		Dim filename As String = saveFileDialog1.FileName

		' The core of PDF generation from HTML/Text using IronPDF
		' IronPDF's ChromePdfRenderer accurately renders HTML, CSS, and JavaScript.
		Dim renderer = New ChromePdfRenderer()

		' The RenderHtmlAsPdf method converts an HTML string to a PDF document.
		' This is incredibly powerful for generating dynamic reports, invoices, tickets, etc.
		' from HTML templates.
		Using pdfDocument = renderer.RenderHtmlAsPdf(PdfText.Text)
			pdfDocument.SaveAs(filename)
		End Using

		MessageBox.Show("PDF Generated Successfully at: " & filename, "Success", MessageBoxButtons.OK, MessageBoxIcon.Information)
	End If
End Sub

C# PDF 생성 코드 설명:

• IronPdf.License.LicenseKey: IronPDF 라이센스 키를 설정하는 것이 좋은 습관입니다. 라이센스 키가 있는 경우 주석을 제거하고 "YourLicenseKey..."를 실제 키로 교체하세요. IronPDF는 라이선스 키 없이 작동하지만, 체험 기간 후에는 문서에 워터마크가 생깁니다.
• SaveFileDialog: 사용자에게 PDF의 저장 위치와 파일 이름을 선택할 수 있도록 하는 표준 Windows 대화상자를 제공합니다.
• ChromePdfRenderer: IronPDF의 HTML-to-PDF 기능의 핵심입니다. 최대 충실도를 위해 내장 Chromium 엔진을 사용합니다.
• RenderHtmlAsPdf(PdfText.Text): 이 단일 메서드는 RichTextBox에서 문자열 콘텐츠(리치 HTML 가능)를 가져와 PDF 문서 객체로 변환합니다.
• SaveAs(filename): 이 메서드는 생성된 PDF 문서를 사용자가 지정한 경로에 저장합니다.
• using 문을 사용한 pdfDocument은 리소스가 올바르게 관리되도록 보장합니다.

IronPDF는 HTML을 PDF로 변환하는 것과 같은 잠재적으로 복잡한 작업을 몇 가지 주요 코드 라인만 사용하여 쉽게 처리합니다. 이는 PDF C# 생성을 신속하고 안정적으로 필요로 하는 개발자에게 큰 장점입니다.

<h1>My First C# PDF Document</h1>
<p>This PDF was generated using <strong>IronPDF</strong> in a C# application.</p>
<p>IronPDF makes it very easy to convert HTML content, including styles and images, into professional PDF files.</p>
<ul>
    <li>Easy to use</li>
    <li>Accurate rendering</li>
    <li>Feature-rich</li>
</ul>

<h1>My First C# PDF Document</h1>
<p>This PDF was generated using <strong>IronPDF</strong> in a C# application.</p>
<p>IronPDF makes it very easy to convert HTML content, including styles and images, into professional PDF files.</p>
<ul>
    <li>Easy to use</li>
    <li>Accurate rendering</li>
    <li>Feature-rich</li>
</ul>

단계 5: URL에서 PDF 생성하기 위한 C# 코드 작성

실시간 웹페이지에서 PDF 생성은 또 다른 일반적인 요구사항입니다. IronPDF는 이를 간단하게 처리합니다. 폼 디자이너에서 'Generate PDF FROM URL' 버튼 (GeneratePDFFromURLButton)을 더블 클릭하여 클릭 이벤트 핸들러를 생성합니다.

다음 C# 코드를 추가하세요:

private void GeneratePDFFromURLButton_Click(object sender, EventArgs e)
{
    // IronPdf.License.LicenseKey = "YourLicenseKey-GetYourKeyFromIronPdf.com"; 

    if (string.IsNullOrWhiteSpace(URL.Text))
    {
        MessageBox.Show("Please enter a valid URL.", "Input Error", MessageBoxButtons.OK, MessageBoxIcon.Warning);
        return;
    }

    SaveFileDialog saveFileDialog1 = new SaveFileDialog();
    saveFileDialog1.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
    saveFileDialog1.Title = "Save PDF From URL As";
    saveFileDialog1.DefaultExt = "pdf";
    saveFileDialog1.Filter = "PDF files (*.pdf)|*.pdf|All files (*.*)|*.*";
    saveFileDialog1.FilterIndex = 1;
    saveFileDialog1.RestoreDirectory = true;

    if (saveFileDialog1.ShowDialog() == DialogResult.OK)
    {
        string filename = saveFileDialog1.FileName;
        try
        {
            var renderer = new ChromePdfRenderer();
            // RenderUrlAsPdf fetches the content from the URL and converts it to PDF.
            // This is excellent for archiving web pages or creating PDFs from online reports.
            using (var pdfDocument = renderer.RenderUrlAsPdf(URL.Text))
            {
                pdfDocument.SaveAs(filename);
            }
            MessageBox.Show("PDF from URL Generated Successfully at: " + filename, "Success", MessageBoxButtons.OK, MessageBoxIcon.Information);
        }
        catch (Exception ex)
        {
            MessageBox.Show("Error generating PDF from URL: " + ex.Message, "Error", MessageBoxButtons.OK, MessageBoxIcon.Error);
        }
    }
}

private void GeneratePDFFromURLButton_Click(object sender, EventArgs e)
{
    // IronPdf.License.LicenseKey = "YourLicenseKey-GetYourKeyFromIronPdf.com"; 

    if (string.IsNullOrWhiteSpace(URL.Text))
    {
        MessageBox.Show("Please enter a valid URL.", "Input Error", MessageBoxButtons.OK, MessageBoxIcon.Warning);
        return;
    }

    SaveFileDialog saveFileDialog1 = new SaveFileDialog();
    saveFileDialog1.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
    saveFileDialog1.Title = "Save PDF From URL As";
    saveFileDialog1.DefaultExt = "pdf";
    saveFileDialog1.Filter = "PDF files (*.pdf)|*.pdf|All files (*.*)|*.*";
    saveFileDialog1.FilterIndex = 1;
    saveFileDialog1.RestoreDirectory = true;

    if (saveFileDialog1.ShowDialog() == DialogResult.OK)
    {
        string filename = saveFileDialog1.FileName;
        try
        {
            var renderer = new ChromePdfRenderer();
            // RenderUrlAsPdf fetches the content from the URL and converts it to PDF.
            // This is excellent for archiving web pages or creating PDFs from online reports.
            using (var pdfDocument = renderer.RenderUrlAsPdf(URL.Text))
            {
                pdfDocument.SaveAs(filename);
            }
            MessageBox.Show("PDF from URL Generated Successfully at: " + filename, "Success", MessageBoxButtons.OK, MessageBoxIcon.Information);
        }
        catch (Exception ex)
        {
            MessageBox.Show("Error generating PDF from URL: " + ex.Message, "Error", MessageBoxButtons.OK, MessageBoxIcon.Error);
        }
    }
}

Private Sub GeneratePDFFromURLButton_Click(ByVal sender As Object, ByVal e As EventArgs)
	' IronPdf.License.LicenseKey = "YourLicenseKey-GetYourKeyFromIronPdf.com"; 

	If String.IsNullOrWhiteSpace(URL.Text) Then
		MessageBox.Show("Please enter a valid URL.", "Input Error", MessageBoxButtons.OK, MessageBoxIcon.Warning)
		Return
	End If

	Dim saveFileDialog1 As New SaveFileDialog()
	saveFileDialog1.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments)
	saveFileDialog1.Title = "Save PDF From URL As"
	saveFileDialog1.DefaultExt = "pdf"
	saveFileDialog1.Filter = "PDF files (*.pdf)|*.pdf|All files (*.*)|*.*"
	saveFileDialog1.FilterIndex = 1
	saveFileDialog1.RestoreDirectory = True

	If saveFileDialog1.ShowDialog() = DialogResult.OK Then
		Dim filename As String = saveFileDialog1.FileName
		Try
			Dim renderer = New ChromePdfRenderer()
			' RenderUrlAsPdf fetches the content from the URL and converts it to PDF.
			' This is excellent for archiving web pages or creating PDFs from online reports.
			Using pdfDocument = renderer.RenderUrlAsPdf(URL.Text)
				pdfDocument.SaveAs(filename)
			End Using
			MessageBox.Show("PDF from URL Generated Successfully at: " & filename, "Success", MessageBoxButtons.OK, MessageBoxIcon.Information)
		Catch ex As Exception
			MessageBox.Show("Error generating PDF from URL: " & ex.Message, "Error", MessageBoxButtons.OK, MessageBoxIcon.Error)
		End Try
	End If
End Sub

설명:

• URL.Text: 폼의 TextBox 컨트롤에서 URL 문자열을 가져옵니다.
• RenderUrlAsPdf(URL.Text): 이 강력한 IronPDF 메서드는 주어진 URL로 이동하여 그 내용을 (HTML, CSS, JavaScript, 이미지 포함) 렌더링하고 PDF 문서로 변환합니다.
• 오류 처리 (try-catch)는 네트워크 문제나 유효하지 않은 URL이 발생할 수 있으므로 견고성을 위해 포함되어 있습니다.

결론: IronPDF로 C# PDF 생성을 간소화하십시오

이 튜토리얼이 보여주듯이, IronPDF는 C# PDF 생성에 필요한 강력하면서도 간단한 솔루션을 제공합니다. 복잡한 HTML 페이지를 CSS와 JavaScript로 변환하거나, 데이터에서 동적 보고서를 생성하거나, 실시간 URL에서 PDF를 생성하거나, .NET 애플리케이션 내에서 강력한 PDF 편집 기능이 필요할 때, IronPDF는 효율적으로 작업을 수행하는 도구와 성능을 제공합니다.

PDF C# 프로젝트를 생성할 때, 렌더링 충실도나 기능 세트에 제한이 있을 수 있는 무료 라이브러리와 상당한 보일러플레이트 코드를 요구하는 더 복잡한 솔루션 사이에서 선택을 자주 해야 합니다. IronPDF는 포괄적이고 상용 지원되는 .NET PDF 라이브러리로, 개발을 간소화하고, 고품질 출력을 보장하며, 기본 PDF 생성을 초월하는 풍부한 기능을 제공합니다.

PDF를 C#에서 생성하고 조작하는 최고의 방법을 경험해보실 준비가 되셨나요?

• 오늘 무료 IronPDF 체험판을 시작하십시오
• 상세 문서 및 더 많은 예제 탐색
• 라이선스 옵션 보기
• Iron Suite 발견: 더 적은 비용으로 더 많은 .NET 도구 얻기 (Iron Suite에는 여러 .NET 라이브러리가 포함되어 있어 다른 문서 형식이나 작업을 처리할 때 큰 가치를 제공합니다.)

IronPDF를 선택함으로써, C# 프로젝트에 최고의 PDF 생성 및 조작 엔진을 장착하여 소중한 개발 시간을 절약하고 매번 전문적인 품질의 픽셀 완벽한 PDF 문서를 보장합니다. C#에서 HTML을 PDF로 변환하는 방법에 대한 자세한 가이드를 통해 더 알아보세요.