Wie man Basis-URLs in der PDF-Erstellung mit C# verwendet

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

Schnellstart: Basis-URLs in IronPDF implementieren

Beginnen Sie mit IronPDF, indem Sie Basis-URLs für nahtloses Laden von Assets während der Konvertierung von HTML in PDF in .NET C# implementieren. Dieses Beispiel zeigt, wie man BaseUrlOrPath einstellt, um sicherzustellen, dass alle CSS-, JavaScript und Bilddateien korrekt referenziert werden, wodurch die PDF-Generierung mit minimalem Aufwand vereinfacht wird.

  1. Installieren Sie IronPDF mit NuGet Package Manager

    PM > Install-Package IronPdf
  2. Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

    new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("<img src='icons/logo.png'>", @"C:\site\assets\").SaveAs("with-assets.pdf");
  3. Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute, IronPDF in Ihrem Projekt zu verwenden, mit einer kostenlosen Testversion

    arrow pointer


Wie rendere ich PDFs aus HTML-Strings mit Bild- und CSS-Assets?

Legen Sie bei der Konvertierung von HTML-Strings in PDF einen BaseUrlOrPath-Parameter für Elemente wie CSS, JavaScript-Dateien und Bilder fest. Der Parameter BaseUrlOrPath gibt die Basis-URL an, von der aus alle Assets relativ geladen werden.

Dies kann eine Web-URL sein, die mit "http" beginnt, um Remote-Assets zu laden, oder ein lokaler Dateipfad für den Zugriff auf Assets auf der Festplatte. Die korrekte Einstellung von BaseUrlOrPath gewährleistet, dass Assets während der Konvertierung ordnungsgemäß geladen werden. Weitere Einzelheiten zur Konvertierung von HTML in PDF finden Sie in unserem umfassenden HTML zu PDF Tutorial.

: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

Für komplexe Szenarien, bei denen externe Assets zum Einsatz kommen, lesen Sie unseren Leitfaden zur Verwaltung von Schriftarten oder Hinzufügen von Bildern zu PDFs.

Wie konfiguriere ich Basis-URLs in MVC-Anwendungen?

In MVC-Anwendungen erfordert die Angabe von Bilddateipfaden eine sorgfältige Konfiguration. To ensure IronPDF finds images and displays them correctly on the website, configure the baseUrl and HTML src="" attribute properly.

Mit der unten gezeigten Dateihierarchie

  • baseUrlOrPath zu @"wwwroot/image"
  • src Attribut zu "../image/Sample.jpg"
wwwroot
└── image
    ├── Sample.jpg
    └── Sample.png

Zum Beispiel:

: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-spezifische Implementierungen finden Sie in unserem CSHTML to PDF (MVC Core) guide.

Welche Dateipfadformate sollte ich vermeiden?

Warnung

Dateipfadformate, die nicht funktionieren

Diese Formate funktionieren im Chrome-Browser, verweisen aber in MVC-Anwendungen auf die falschen Verzeichnisse. Sie funktionieren mit IronPDF, wenn baseUrlOrPath in der Methode RenderHtmlAsPdf angegeben wird:

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

Diese Formate funktionieren mit MVC-Anwendungen, aber nicht mit IronPDF-Dateipfaden:

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

)}]

Was sind allgemeine Tipps zur Fehlerbehebung beim Laden von Assets?

Wenn Assets nicht geladen werden können, sollten Sie diese Schritte zur Fehlerbehebung beachten:

  1. Überprüfen Sie absolute Pfade: Verwenden Sie während der Entwicklung absolute Dateipfade, um die Zugänglichkeit zu bestätigen
  2. Dateiberechtigungen prüfen: Sicherstellen, dass die Anwendung Lesezugriff auf Asset-Verzeichnisse hat
  3. Testen Sie mit Remote-URLs: Verwenden Sie vollständig qualifizierte URLs, um Pfadprobleme zu isolieren
  4. Protokollierung aktivieren: Verwenden Sie die Benutzerdefinierte Protokollierung von IronPDF, um das Laden von Assets zu debuggen
// 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

Wie füge ich HTML-Kopf- und -Fußzeilen mit Bildern hinzu?

Beim Rendern von HTML-Kopf- und -Fußzeilen in neue oder bestehende PDF-Dateien werden diese als eigenständige HTML-Dokumente behandelt und erben nicht die BaseURL der PDF-Datei. Umfassende Optionen für Kopf- und Fußzeilen finden Sie in unserem Handbuch für Kopf- und Fußzeilen.

Legen Sie eine BaseURL fest, von der Assets geladen werden können:

: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

Warum erben Kopfzeilen nicht die Basis-URLs vom Hauptdokument?

Kopf- und Fußzeilen werden aus Leistungs- und Isolationsgründen als separate HTML-Dokumente dargestellt. Dieses Design ermöglicht:

  • Unabhängiges Styling ohne Beeinträchtigung des Hauptinhalts
  • Konsistentes Rendering auf allen Seiten
  • Bessere Speicherverwaltung für große Dokumente
  • Flexibilität bei der Verwendung verschiedener Asset-Quellen

Wie lege ich unterschiedliche Basis-URLs für Header und Inhalt fest?

Geben Sie unterschiedliche Basis-URLs für Kopf- und Fußzeilen sowie den Hauptinhalt an, um die Inhalte effektiv zu organisieren:

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

Wie konvertiere ich HTML-Dateien in PDF mit lokalen Assets?

Bei der Konvertierung von HTML-Dateien in PDF wird davon ausgegangen, dass alle Inhalte in der jeweiligen Datei enthalten sind. Erfahren Sie mehr über die Konvertierung von HTML-Dateien in unserem HTML-Datei in PDF-Leitfaden.

: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

Im obigen Beispiel werden alle JS-, CSS- und Bilddateien aus dem Ordner C:\Assets auf der Festplatte geladen - demselben Verzeichnis wie die HTML-Datei.

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

: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

Hinweis:Die ChromePdfRenderOptions.CustomCssUrl Eigenschaft funktioniert derzeit nur beim Rendern von HTML-Strings in PDFs mit der RenderHtmlAsPdf Methode.

Wann sollte ich CustomCssUrl für zusätzliches Styling verwenden?

CustomCssUrl ist ideal für:

  • Print-spezifische Stile: Ausblenden von Navigationsmenüs oder interaktiven Elementen
  • PDF-Layout-Optimierung: Ränder und Seitenumbrüche für den Druck anpassen
  • Bedingte Formatierung: Stile nur bei der Erstellung von PDFs anwenden
  • A/B-Testing: Testen Sie verschiedene PDF-Layouts, ohne den HTML-Quelltext zu ändern

Wie gehe ich mit relativen Asset-Pfaden in HTML-Dateien um?

Wenn Sie mit HTML-Dateien arbeiten, die relative Pfade enthalten, stellen Sie sicher, dass Ihre Dateistruktur die Verweise unterstützt:

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

Wie kodiere ich Bilder direkt in HTML mit Base64?

Bildinhalte können direkt in HTML-Dateien oder Strings kodiert werden, um Probleme mit fehlenden Bildern zu vermeiden. Verwenden Sie für diesen Ansatz die base64-Kodierung. Für die Arbeit mit verschiedenen Bildformaten siehe unseren Bildleitfaden.

  1. Beschaffen Sie sich zunächst die Binärdaten des Bildes, indem Sie die Datei lesen oder über eine Netzwerkanforderung empfangen.
  2. Verwenden Sie die Convert.ToBase64String-Methode in Microsoft .NET , um Binärdaten in Base64 zu konvertieren.
  3. Erstellen Sie das Bild-Tag in HTML mit "data:image/svg+xml;base64," vor den base64-Daten. Beachten Sie, dass der Bildtyp vor den base64-Daten angegeben wird. Besuchen Sie die MDN Web Docs zu Bildtypen und -formaten für weitere Informationen zu Bildformat-Typen.
: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

Warum sollte ich Base64-Kodierung über Dateiverweise wählen?

Die Base64-Kodierung bietet mehrere Vorteile:

  • Eigenständiges HTML: Keine externen Abhängigkeiten, was die Verteilung vereinfacht
  • Plattformübergreifende Kompatibilität: Funktioniert unabhängig von den Unterschieden im Dateisystem
  • Sicherheit: Kein Zugriff auf das Dateisystem erforderlich, um Sicherheitsrisiken zu verringern
  • Zuverlässigkeit: Eliminiert Fehler bei fehlenden Assets in der Produktion
  • Versionskontrolle: Bilder sind Teil von HTML, was die Versionierung vereinfacht

Beachten Sie jedoch diese Kompromisse:

  • Erhöhte HTML-Größe: Base64-Kodierung erhöht die Größe um etwa 33 %
  • Kein Caching: Eingebettete Bilder können nicht separat zwischengespeichert werden
  • Speichernutzung: Das gesamte Bild muss im Speicher geladen werden

Welche Bildformate funktionieren am besten mit Base64-Kodierung?

Verschiedene Bildformate sind bei der base64-Kodierung unterschiedlich effizient:

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

Wie wirkt sich Base64-Kodierung auf die Größe von PDF-Dateien aus?

Die Base64-Kodierung beeinflusst die PDF-Größe auf vorhersehbare Weise:

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

Für optimale Ergebnisse:

  • Verwenden Sie base64 für kleine Icons und Logos (< 50KB)
  • Verwenden Sie externe Referenzen für große Bilder und Fotos
  • Vor der Kodierung Komprimierung berücksichtigen
  • Geeignete Bildformate für den Inhaltstyp verwenden

Für fortgeschrittene PDF-Optimierungstechniken lesen Sie unseren Leitfaden zur PDF-Komprimierung.

Häufig gestellte Fragen

Wie kann ich sicherstellen, dass CSS- und JavaScript-Assets bei der Konvertierung von HTML in PDF korrekt geladen werden?

IronPDF ermöglicht die Angabe eines BaseUrlOrPath-Parameters bei der Konvertierung von HTML in PDF. Bei diesem Parameter kann es sich um eine Web-URL oder einen lokalen Dateipfad handeln, der als Basisreferenz für alle relativen Asset-Pfade in Ihrem HTML-Code dient und sicherstellt, dass CSS, JavaScript und Bilder korrekt geladen werden.

Wofür wird der Parameter BaseUrlOrPath verwendet?

Der BaseUrlOrPath-Parameter in IronPDF gibt die Basis-URL an, von der aus alle Assets (CSS, JavaScript, Bilder) während der HTML-zu-PDF-Konvertierung relativ zu ihr geladen werden. Er kann entweder auf eine mit "http" beginnende Web-URL für Remote-Assets oder auf einen lokalen Dateipfad für festplattenbasierte Assets gesetzt werden.

Wie kann ich ein PDF mit Assets in nur einer Codezeile rendern?

Sie können den ChromePdfRenderer von IronPDF verwenden, um HTML mit Assets in einer Zeile zu rendern: `new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("", @"C:\site\assets\").SaveAs("with-assets.pdf");`. Dadurch wird die BaseUrlOrPath festgelegt, um sicherzustellen, dass alle Assets ordnungsgemäß geladen werden.

Wie konfiguriere ich Bildpfade in MVC-Anwendungen für die PDF-Generierung?

In MVC-Anwendungen, die IronPDF verwenden, setzen Sie das baseUrlOrPath auf Ihr wwwroot-Unterverzeichnis (z. B. @"wwwroot/image") und konfigurieren das HTML src-Attribut mit dem relativen Pfad (z. B. "../image/Sample.jpg"). Dadurch wird sichergestellt, dass die Bilder sowohl auf der Website als auch in der generierten PDF-Datei korrekt angezeigt werden.

Kann ich bei der Konvertierung von HTML in PDF sowohl lokale als auch entfernte Elemente verwenden?

Ja, IronPDF unterstützt sowohl lokale als auch entfernte Assets. Für Remote-Assets setzen Sie BaseUrlOrPath auf eine Web-URL, die mit "http" beginnt. Für lokale Assets verwenden Sie einen Dateipfad auf Ihrer Festplatte. Dank dieser Flexibilität können Sie bei der PDF-Erstellung auf Assets aus verschiedenen Quellen verweisen.

Was passiert, wenn ich den Parameter BaseUrlOrPath nicht setze?

Wenn der Parameter BaseUrlOrPath in IronPDF nicht gesetzt wird, werden relative Asset-Pfade in Ihrem HTML-Code nicht korrekt aufgelöst, was dazu führt, dass CSS-Stile, JavaScript-Funktionen und Bilder in Ihrer generierten PDF-Datei fehlen. Geben Sie diesen Parameter immer an, wenn Ihr HTML relative Asset-Referenzen enthält.

Curtis Chau
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender ...

Weiterlesen
Bereit anzufangen?
Nuget Downloads 17,803,474 | Version: 2026.3 gerade veröffentlicht
Still Scrolling Icon

Scrollst du immer noch?

Sie brauchen schnell einen Beweis? PM > Install-Package IronPdf
Führen Sie eine Probe aus Sehen Sie zu, wie Ihr HTML-Code in eine PDF-Datei umgewandelt wird.