1. IronPDF
  2. 방법
  3. 기본 URL 및 자산 인코딩
C#을 사용하여 PDF 생성 시 기본 URL을 사용하는 방법

How to Use Base URLs & Asset Encoding in C# .NET 10

커티스 차우
커티스 차우
업데이트됨:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF에서 기본 URL을 사용하면 BaseUrlOrPath 매개변수를 지정하여 HTML을 PDF로 변환하는 동안 CSS, JavaScript 및 이미지 자산이 제대로 로드되도록 할 수 있습니다. 이 매개변수는 웹 URL 또는 상대적 자산 해석을 위한 로컬 파일 경로가 될 수 있습니다.

빠른 시작: IronPDF에서 기본 URL 구현

.NET C#에서 HTML을 PDF로 변환하는 동안 원활한 자산 로딩을 위해 기본 URL을 구현하여 IronPDF 사용을 시작해 보세요. 이 예제는 모든 CSS, JavaScript 및 이미지가 올바르게 참조되도록 BaseUrlOrPath를 설정하는 방법을 보여주며, 이를 통해 최소한의 설정으로 PDF 생성을 간소화할 수 있습니다.

Nuget Icon지금 바로 NuGet을 사용하여 PDF 만들기를 시작하세요.

  1. NuGet 패키지 관리자를 사용하여 IronPDF를 설치하세요.

    PM > Install-Package IronPdf

  2. 다음 코드 조각을 복사하여 실행하세요.

    new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("<img src='icons/logo.png'>", @"C:\site\assets\").SaveAs("with-assets.pdf");

  3. 실제 운영 환경에서 테스트할 수 있도록 배포하세요.

    지금 바로 무료 체험판을 통해 프로젝트에서 IronPDF를 사용해 보세요.
    arrow pointer
### 최소 워크플로우(5단계)
  1. HTML, CSS 및 이미지 변환을 지원하는 IronPDF를 다운로드하세요.
  2. HTML에서 외부 이미지에 대한 **`BaseUrlOrPath`** 매개변수를 지정합니다.
  3. 웹 및 PDF 표시를 위해 MVC에서 올바른 **`src`** 구성하십시오.
  4. 사용자 지정 헤더 및 푸터에 대한 **`BaseUrl`** 속성을 지정합니다.
  5. 출력된 PDF 파일을 확인하세요.


이미지와 CSS 파일을 사용하여 HTML 문자열에서 PDF를 렌더링하는 방법은 무엇인가요?

HTML 문자열을 PDF로 변환할 때 CSS, JavaScript 파일 및 이미지와 같은 자산에 대해 BaseUrlOrPath 매개변수를 설정하십시오. BaseUrlOrPath는 모든 자산이 로드되는 기준 URL을 지정합니다.

이는 원격 자산을 로드하기 위한 'http'로 시작하는 웹 URL이거나 디스크에 있는 자산에 액세스하기 위한 로컬 파일 경로일 수 있습니다. BaseUrlOrPath를 올바르게 설정하면 변환 중에 자산이 제대로 로드됩니다. HTML을 PDF로 변환하는 방법에 대한 자세한 내용은 종합적인 HTML-PDF 변환 튜토리얼을 참조하세요.

:path=/static-assets/pdf/content-code-examples/how-to/base-urls-baseurl.cs
using IronPdf;

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

string baseUrl = @"C:\site\assets\";
string html = "<img src='icons/iron.png'>";

// Render HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html, baseUrl);

// Export PDF
pdf.SaveAs("html-with-assets.pdf");
$vbLabelText   $csharpLabel

외부 자산을 사용하는 복잡한 시나리오의 경우 글꼴 관리 또는 PDF에 이미지 추가에 대한 가이드를 참조하세요.

MVC 애플리케이션에서 기본 URL을 어떻게 구성하나요?

MVC 애플리케이션에서 이미지 파일 경로를 지정하려면 세심한 구성이 필요합니다. To ensure IronPDF finds images and displays them correctly on the website, configure the baseUrl and HTML src="" attribute properly.

아래와 같이 파일 계층 구조가 설정되어 있습니다.

  • baseUrlOrPath를 @"wwwroot/image"로
  • src "../image/Sample.jpg"에 대한 속성
wwwroot
└── image
    ├── Sample.jpg
    └── Sample.png

예를 들어:

:path=/static-assets/pdf/content-code-examples/how-to/base-mvc.cs
// Instantiate ChromePdfRenderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Render HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf("html.Result", @"wwwroot/image");
$vbLabelText   $csharpLabel 

<img src="../image/Sample.jpg"/>
<img src="../image/Sample.png"/>

<img src="../image/Sample.jpg"/>
<img src="../image/Sample.png"/>
HTML

ASP.NET Core MVC 관련 구현에 대해서는 CSHTML을 PDF로 변환(MVC Core) 가이드를 참조하십시오.

피해야 할 파일 경로 형식은 무엇인가요?

[{안에:(

작동하지 않는 파일 경로 형식

이러한 형식은 Chrome 브라우저에서는 작동하지만 MVC 앱에서는 잘못된 디렉터리를 가리킵니다. baseUrlOrPath가 RenderHtmlAsPdf 메서드에 제공되면 IronPDF에서 작동합니다.

<img src="image/footer.png"/>  
<img src="./image/footer.png"/>  
<img src="image/footer.png"/>  
<img src="./image/footer.png"/>
HTML

이러한 형식은 MVC 앱에서는 작동하지만 IronPDF 파일 경로에서는 작동하지 않습니다.

<img src="/image/footer.png"/>  
<img src="~/image/footer.png"/>
<img src="/image/footer.png"/>  
<img src="~/image/footer.png"/>
HTML

)}]

자산 로딩 시 흔히 발생하는 문제 해결 팁은 무엇인가요?

자산이 로드되지 않을 경우 다음 문제 해결 단계를 고려하십시오.

  1. 절대 경로 확인 : 개발 단계에서 절대 파일 경로를 사용하여 접근성을 확인하십시오.
  2. 파일 권한 확인 : 애플리케이션이 자산 디렉토리에 대한 읽기 권한이 있는지 확인하십시오.
  3. 원격 URL을 사용하여 테스트 : 경로 문제를 분리하려면 정규화된 URL을 사용하십시오.
  4. 로깅 활성화 : IronPDF의 사용자 지정 로깅을 사용하여 에셋 로딩 문제를 디버깅하세요. 
// Example: Debug asset loading with absolute paths
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Enable debug logging
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(500); // Give assets time to load

// Use absolute path for testing
string absoluteBasePath = Path.GetFullPath(@"C:\MyProject\wwwroot\assets");
string html = @"
    <html>
    <head>
        <link rel='stylesheet' href='styles/main.css'>
    </head>
    <body>
        <img src='images/logo.png' />
        <script src='scripts/app.js'></script>
    </body>
    </html>";

PdfDocument pdf = renderer.RenderHtmlAsPdf(html, absoluteBasePath);
// Example: Debug asset loading with absolute paths
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Enable debug logging
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(500); // Give assets time to load

// Use absolute path for testing
string absoluteBasePath = Path.GetFullPath(@"C:\MyProject\wwwroot\assets");
string html = @"
    <html>
    <head>
        <link rel='stylesheet' href='styles/main.css'>
    </head>
    <body>
        <img src='images/logo.png' />
        <script src='scripts/app.js'></script>
    </body>
    </html>";

PdfDocument pdf = renderer.RenderHtmlAsPdf(html, absoluteBasePath);
$vbLabelText   $csharpLabel

HTML 헤더와 푸터에 이미지를 추가하는 방법은 무엇인가요?

새 PDF 또는 기존 PDF에 HTML 헤더와 푸터를 렌더링할 때, 이들은 독립적인 HTML 문서로 처리되며 PDF의 BaseURL을 상속하지 않습니다. 헤더 및 푸터 옵션에 대한 자세한 내용은 헤더 및 푸터 가이드를 참조하세요.

자산을 로드할 수 있는 BaseURL을 설정합니다.

:path=/static-assets/pdf/content-code-examples/how-to/base-header-footer.cs
using IronPdf;
using System;

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

// Add header
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    MaxHeight = 20,
    HtmlFragment = "<img src='logo.png'>",
    BaseUrl = new Uri(@"C:\assets\images\").AbsoluteUri
};
$vbLabelText   $csharpLabel

헤더가 메인 문서의 기본 URL을 상속받지 않는 이유는 무엇입니까?

성능 향상 및 격리를 위해 헤더와 푸터는 별도의 HTML 문서로 렌더링됩니다. 이 설계는 다음과 같은 이점을 제공합니다.

  • 메인 콘텐츠에 영향을 주지 않고 독립적인 스타일링 가능
  • 모든 페이지에서 일관된 렌더링
  • 대용량 문서 처리를 위한 향상된 메모리 관리 기능
  • 다양한 자산 소스를 활용할 수 있는 유연성

헤더와 콘텐츠에 서로 다른 기본 URL을 설정하려면 어떻게 해야 하나요?

헤더, 푸터 및 본문 콘텐츠에 대해 서로 다른 기본 URL을 지정하여 자산을 효과적으로 구성하세요.

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Main content base URL
string contentBaseUrl = @"C:\website\public\";

// Header specific assets
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<img src='header-logo.png'><link rel='stylesheet' href='header.css'>",
    BaseUrl = new Uri(@"C:\website\headers\").AbsoluteUri
};

// Footer specific assets
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div class='footer'>© 2024 Company</div><link rel='stylesheet' href='footer.css'>",
    BaseUrl = new Uri(@"C:\website\footers\").AbsoluteUri
};

// Render main content with its own base URL
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Main Content</h1>", contentBaseUrl);
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Main content base URL
string contentBaseUrl = @"C:\website\public\";

// Header specific assets
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<img src='header-logo.png'><link rel='stylesheet' href='header.css'>",
    BaseUrl = new Uri(@"C:\website\headers\").AbsoluteUri
};

// Footer specific assets
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div class='footer'>© 2024 Company</div><link rel='stylesheet' href='footer.css'>",
    BaseUrl = new Uri(@"C:\website\footers\").AbsoluteUri
};

// Render main content with its own base URL
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Main Content</h1>", contentBaseUrl);
$vbLabelText   $csharpLabel

로컬 자산을 사용하여 HTML 파일을 PDF로 변환하는 방법은 무엇입니까?

HTML 파일을 PDF로 변환할 때 모든 자산은 해당 파일에 로컬로 존재한다고 가정합니다. HTML 파일을 PDF로 변환하는 방법에 대한 자세한 내용은 HTML 파일 PDF 변환 가이드를 참조하세요.

:path=/static-assets/pdf/content-code-examples/how-to/base-html-file.cs
using IronPdf;

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

// Render HTML file to PDF
PdfDocument pdf = renderer.RenderHtmlFileAsPdf("C:\\Assets\\TestInvoice1.html");

// Export PDF
pdf.SaveAs("Invoice.pdf");
$vbLabelText   $csharpLabel

위 예시에서 모든 JS, CSS 및 이미지 파일은 디스크의 C:\Assets 폴더(HTML 파일과 동일한 디렉토리)에서 로드됩니다.

For convenience, use CustomCssUrl in ChromePdfRenderOptions for Additional Stylesheets to specify an additional stylesheet used only for .NET PDF rendering if desired. 예를 들어:

:path=/static-assets/pdf/content-code-examples/how-to/base-html-file-baseurl.cs
using IronPdf;

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

// Set additional CSS url
renderer.RenderingOptions.CustomCssUrl = "./style.css";

// Render HTML file to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export PDF
pdf.SaveAs("tryCss.pdf");
$vbLabelText   $csharpLabel

참고해 주세요@ChromePdfRenderOptions.CustomCssUrl 속성은 현재 RenderHtmlAsPdf 메서드를 사용하여 HTML 문자열에서 PDF로 렌더링할 때만 작동합니다.

CustomCssUrl을 사용하여 추가 스타일을 적용해야 하는 경우는 언제인가요?

CustomCssUrl은 다음과 같은 경우에 적합합니다.

  • 인쇄 전용 스타일 : 탐색 메뉴 또는 대화형 요소 숨기기
  • PDF 레이아웃 최적화 : 인쇄에 맞게 여백과 페이지 나누기를 조정합니다.
  • 조건부 서식 : PDF 생성 시에만 스타일 적용
  • A/B 테스트 : 원본 HTML을 수정하지 않고 다양한 PDF 레이아웃을 테스트합니다.

HTML 파일에서 상대 경로로 자산 경로를 처리하는 방법은 무엇인가요?

상대 경로가 포함된 HTML 파일을 다룰 때는 파일 구조가 해당 참조를 지원하는지 확인하십시오.

// Example HTML file structure
/*
C:\Projects\Reports\
    ├── invoice.html
    ├── css\
    │   └── styles.css
    ├── js\
    │   └── calculations.js
    └── images\
        └── logo.png
*/

// HTML content with relative paths
string htmlContent = @"
<!DOCTYPE html>
<html>
<head>
    <link rel='stylesheet' href='css/styles.css'>
    <script src='js/calculations.js'></script>
</head>
<body>
    <img src='images/logo.png' alt='Company Logo'>
    <h1>Invoice #12345</h1>
</body>
</html>";

// Save HTML and render
File.WriteAllText(@"C:\Projects\Reports\invoice.html", htmlContent);
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlFileAsPdf(@"C:\Projects\Reports\invoice.html");
pdf.SaveAs("invoice-output.pdf");
// Example HTML file structure
/*
C:\Projects\Reports\
    ├── invoice.html
    ├── css\
    │   └── styles.css
    ├── js\
    │   └── calculations.js
    └── images\
        └── logo.png
*/

// HTML content with relative paths
string htmlContent = @"
<!DOCTYPE html>
<html>
<head>
    <link rel='stylesheet' href='css/styles.css'>
    <script src='js/calculations.js'></script>
</head>
<body>
    <img src='images/logo.png' alt='Company Logo'>
    <h1>Invoice #12345</h1>
</body>
</html>";

// Save HTML and render
File.WriteAllText(@"C:\Projects\Reports\invoice.html", htmlContent);
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlFileAsPdf(@"C:\Projects\Reports\invoice.html");
pdf.SaveAs("invoice-output.pdf");
$vbLabelText   $csharpLabel

HTML에서 이미지를 Base64로 직접 인코딩하는 방법은 무엇인가요?

이미지 파일은 HTML 파일이나 문자열에 직접 인코딩할 수 있으므로 이미지 누락 문제를 방지할 수 있습니다. 이 방법을 사용하려면 base64 인코딩을 사용하십시오. 다양한 이미지 형식을 다루는 방법에 대해서는 이미지 가이드를 참조하세요.

  1. 먼저 파일을 읽거나 네트워크 요청을 통해 이미지의 바이너리 데이터를 얻습니다.
  2. Microsoft .NET에서 Convert.ToBase64String 메서드를 사용하여 이진 데이터를 base64로 변환합니다.
  3. base64 데이터 앞에 "data:image/svg+xml;base64"를 사용하여 HTML에서 이미지 태그를 구성합니다. 이미지 유형은 base64 데이터보다 먼저 지정된다는 점에 유의하십시오. 이미지 형식 유형에 대한 자세한 내용은 MDN 웹 문서의 이미지 유형 및 형식 섹션을 참조하십시오.
:path=/static-assets/pdf/content-code-examples/how-to/add-images-to-pdfs-base64-image.cs
using IronPdf;
using System;
using System.IO;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Import image file binary data
byte[] binaryData = File.ReadAllBytes("ironpdf-logo-text-dotnet.svg");

// Convert the binary data to base 64
string imgDataUri = Convert.ToBase64String(binaryData);

// Embed in HTML
string html = $"<img src='data:image/svg+xml;base64,{imgDataUri}'>";

// Convert HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Export the PDF
pdf.SaveAs("embedImageBase64.pdf");
$vbLabelText   $csharpLabel

파일 참조 대신 Base64 인코딩을 선택하는 이유는 무엇일까요?

Base64 인코딩은 다음과 같은 몇 가지 장점을 제공합니다.

  • 자체 포함 HTML : 외부 종속성이 없어 배포가 간편합니다.
  • 크로스 플랫폼 호환성 : 파일 시스템 차이에 관계없이 작동합니다.
  • 보안 : 파일 시스템 접근이 필요 없어 보안 위험이 줄어듭니다.
  • 신뢰성 : 생산 과정에서 자산 누락 오류를 제거합니다.
  • 버전 관리 : 이미지는 HTML의 일부이므로 버전 관리가 간편합니다.

하지만 다음과 같은 장단점을 고려해 보세요.

  • HTML 크기 증가 : Base64 인코딩으로 인해 크기가 약 33% 증가합니다.
  • 캐싱 불가 : 내장된 이미지는 별도로 캐싱할 수 없습니다.
  • 메모리 사용량 : 전체 이미지가 메모리에 로드되어야 합니다.

Base64 인코딩에 가장 적합한 이미지 형식은 무엇인가요?

이미지 형식에 따라 base64로 인코딩할 때 효율성이 다릅니다.

// Example: Encoding different image formats
public string EncodeImageWithMimeType(string imagePath)
{
    byte[] imageBytes = File.ReadAllBytes(imagePath);
    string base64 = Convert.ToBase64String(imageBytes);

    // Determine MIME type based on extension
    string extension = Path.GetExtension(imagePath).ToLower();
    string mimeType = extension switch
    {
        ".png" => "image/png",      // Best for graphics with transparency
        ".jpg" or ".jpeg" => "image/jpeg",  // Best for photographs
        ".gif" => "image/gif",       // Best for simple animations
        ".svg" => "image/svg+xml",   // Best for scalable graphics
        ".webp" => "image/webp",     // Best overall compression
        _ => "image/png"             // Default fallback
    };

    return $"data:{mimeType};base64,{base64}";
}

// Usage
string encodedImage = EncodeImageWithMimeType("logo.png");
string html = $"<img src='{encodedImage}' alt='Company Logo'>";
// Example: Encoding different image formats
public string EncodeImageWithMimeType(string imagePath)
{
    byte[] imageBytes = File.ReadAllBytes(imagePath);
    string base64 = Convert.ToBase64String(imageBytes);

    // Determine MIME type based on extension
    string extension = Path.GetExtension(imagePath).ToLower();
    string mimeType = extension switch
    {
        ".png" => "image/png",      // Best for graphics with transparency
        ".jpg" or ".jpeg" => "image/jpeg",  // Best for photographs
        ".gif" => "image/gif",       // Best for simple animations
        ".svg" => "image/svg+xml",   // Best for scalable graphics
        ".webp" => "image/webp",     // Best overall compression
        _ => "image/png"             // Default fallback
    };

    return $"data:{mimeType};base64,{base64}";
}

// Usage
string encodedImage = EncodeImageWithMimeType("logo.png");
string html = $"<img src='{encodedImage}' alt='Company Logo'>";
$vbLabelText   $csharpLabel

Base64 인코딩이 PDF 파일 크기에 미치는 영향은 무엇일까요?

Base64 인코딩은 PDF 크기에 예측 가능한 방식으로 영향을 미칩니다.

// Comparison example
public void CompareFileSizes()
{
    ChromePdfRenderer renderer = new ChromePdfRenderer();

    // Method 1: External image reference
    string htmlExternal = "<img src='large-photo.jpg'>";
    PdfDocument pdfExternal = renderer.RenderHtmlAsPdf(htmlExternal, @"C:\images\");

    // Method 2: Base64 encoded image
    byte[] imageBytes = File.ReadAllBytes(@"C:\images\large-photo.jpg");
    string base64Image = Convert.ToBase64String(imageBytes);
    string htmlBase64 = $"<img src='data:image/jpeg;base64,{base64Image}'>";
    PdfDocument pdfBase64 = renderer.RenderHtmlAsPdf(htmlBase64);

    // Compare sizes
    Console.WriteLine($"Original image: {imageBytes.Length / 1024} KB");
    Console.WriteLine($"PDF with external image: {pdfExternal.BinaryData.Length / 1024} KB");
    Console.WriteLine($"PDF with base64 image: {pdfBase64.BinaryData.Length / 1024} KB");
}
// Comparison example
public void CompareFileSizes()
{
    ChromePdfRenderer renderer = new ChromePdfRenderer();

    // Method 1: External image reference
    string htmlExternal = "<img src='large-photo.jpg'>";
    PdfDocument pdfExternal = renderer.RenderHtmlAsPdf(htmlExternal, @"C:\images\");

    // Method 2: Base64 encoded image
    byte[] imageBytes = File.ReadAllBytes(@"C:\images\large-photo.jpg");
    string base64Image = Convert.ToBase64String(imageBytes);
    string htmlBase64 = $"<img src='data:image/jpeg;base64,{base64Image}'>";
    PdfDocument pdfBase64 = renderer.RenderHtmlAsPdf(htmlBase64);

    // Compare sizes
    Console.WriteLine($"Original image: {imageBytes.Length / 1024} KB");
    Console.WriteLine($"PDF with external image: {pdfExternal.BinaryData.Length / 1024} KB");
    Console.WriteLine($"PDF with base64 image: {pdfBase64.BinaryData.Length / 1024} KB");
}
$vbLabelText   $csharpLabel

최적의 결과를 얻으려면:

  • 작은 아이콘 및 로고(50KB 미만)에는 base64 인코딩을 사용하세요.
  • 큰 이미지나 사진은 외부 자료를 참고하세요.
  • 인코딩 전에 압축을 고려하세요
  • 콘텐츠 유형에 맞는 이미지 형식을 사용하십시오.

고급 PDF 최적화 기술에 대해서는 PDF 압축 가이드를 참조하세요.

자주 묻는 질문

HTML을 PDF로 변환할 때 CSS 및 JavaScript 자산이 올바르게 로드되도록 하려면 어떻게 해야 합니까?

IronPDF를 사용하면 HTML을 PDF로 변환할 때 BaseUrlOrPath 매개변수를 지정할 수 있습니다. 이 매개변수는 웹 URL 또는 로컬 파일 경로가 될 수 있으며, HTML의 모든 상대적인 자산 경로에 대한 기준 참조 역할을 하여 CSS, JavaScript 및 이미지가 올바르게 로드되도록 합니다.

BaseUrlOrPath 매개변수는 무엇에 사용되나요?

IronPDF의 BaseUrlOrPath 매개변수는 HTML을 PDF로 변환하는 동안 모든 자산(CSS, JavaScript, 이미지)이 로드되는 기준 URL을 지정합니다. 이 매개변수는 원격 자산의 경우 'http'로 시작하는 웹 URL로 설정하거나 디스크 기반 자산의 경우 로컬 파일 경로로 설정할 수 있습니다.

단 한 줄의 코드로 에셋이 포함된 PDF를 렌더링하려면 어떻게 해야 할까요?

IronPDF의 ChromePdfRenderer를 사용하면 한 줄로 에셋이 포함된 HTML을 렌더링할 수 있습니다. `new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("", @"C:\site\assets\").SaveAs("with-assets.pdf");`. 이렇게 하면 BaseUrlOrPath가 설정되어 모든 에셋이 제대로 로드됩니다.

MVC 애플리케이션에서 PDF 생성을 위한 이미지 경로를 어떻게 설정하나요?

IronPDF를 사용하는 MVC 애플리케이션에서는 baseUrlOrPath를 wwwroot 하위 디렉터리(예: @"wwwroot/image")로 설정하고 HTML src 속성을 상대 경로(예: "../image/Sample.jpg")로 구성하십시오. 이렇게 하면 웹사이트와 생성된 PDF 모두에서 이미지가 올바르게 표시됩니다.

HTML을 PDF로 변환할 때 로컬 자산과 원격 자산을 모두 사용할 수 있나요?

네, IronPDF는 로컬 자산과 원격 자산을 모두 지원합니다. 원격 자산의 경우, BaseUrlOrPath를 'http'로 시작하는 웹 URL로 설정하세요. 로컬 자산의 경우, 디스크의 파일 경로를 사용하세요. 이러한 유연성을 통해 PDF 생성 과정에서 다양한 소스의 자산을 참조할 수 있습니다.

BaseUrlOrPath 매개변수를 설정하지 않으면 어떻게 되나요?

IronPDF에서 BaseUrlOrPath 매개변수를 설정하지 않으면 HTML의 상대 경로가 제대로 해석되지 않아 생성된 PDF에서 CSS 스타일, JavaScript 기능 및 이미지가 누락될 수 있습니다. HTML에 상대 경로가 포함된 자산 참조가 있는 경우 항상 이 매개변수를 지정하십시오.

커티스 차우
커티스 차우
  지금 바로 엔지니어링 팀과 채팅하세요
기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?
Nuget 다운로드 17,527,568 | 버전: 2026.2 방금 출시되었습니다