How to Convert Razor Views to PDFs Headlessly in C

Dlaczego potrzebuję Razor.Templating.Core zamiast IronPdf.Extensions.Razor?

Razor.Templating.Core zapewnia prawdziwe renderowanie bezinterfejsowe — konwertuje widoki Razor do formatu HTML bez kontekstu internetowego lub okna przeglądarki. To pasuje do usług w tle, aplikacji konsolowych lub środowisk bez interfejsu użytkownika. IronPdf.Extensions.Razor wymaga kontekstu internetowego do działania.

Jaki typ projektu najlepiej nadaje się do generowania PDF bez interfejsu?

Projekty ASP.NET Core Web App (Model-View-Controller) zapewniają niezbędną infrastrukturę widoków Razor z elastycznymi opcjami wdrożenia. Użyj tego podejścia w usługach w tle, Azure Functions lub aplikacjach konsolowych. Zobacz wdrażanie IronPDF na Azure dla generowania w chmurze.

Jak zainstalować wymagane pakiety NuGet?

Zainstaluj pakiety używając Menedżera Pakietów NuGet. Potrzebujesz IronPdf i Razor.Templating.Core:

// Install via Package Manager Console
Install-Package IronPdf
Install-Package Razor.Templating.Core

// Or add to your .csproj file
// <PackageReference Include="IronPdf" Version="2024.x.x" />
// <PackageReference Include="Razor.Templating.Core" Version="1.x.x" />

// Install via Package Manager Console
Install-Package IronPdf
Install-Package Razor.Templating.Core

// Or add to your .csproj file
// <PackageReference Include="IronPdf" Version="2024.x.x" />
// <PackageReference Include="Razor.Templating.Core" Version="1.x.x" />

' Install via Package Manager Console
' Install-Package IronPdf
' Install-Package Razor.Templating.Core

' Or add to your .vbproj file
' <PackageReference Include="IronPdf" Version="2024.x.x" />
' <PackageReference Include="Razor.Templating.Core" Version="1.x.x" />

Jaką treść HTML należy dodać do mojego widoku Razor?

Dodaj HTML, który chcesz wyrenderować jako PDF:

<table class="table">
    <tr>
        <th>Name</th>
        <th>Title</th>
        <th>Description</th>
    </tr>
    <tr>
        <td>John Doe</td>
        <td>Software Engineer</td>
        <td>Experienced software engineer specializing in web development.</td>
    </tr>
    <tr>
        <td>Alice Smith</td>
        <td>Project Manager</td>
        <td>Seasoned project manager with expertise in agile methodologies.</td>
    </tr>
    <tr>
        <td>Michael Johnson</td>
        <td>Data Analyst</td>
        <td>Skilled data analyst proficient in statistical analysis and data visualization.</td>
    </tr>
</table>

<table class="table">
    <tr>
        <th>Name</th>
        <th>Title</th>
        <th>Description</th>
    </tr>
    <tr>
        <td>John Doe</td>
        <td>Software Engineer</td>
        <td>Experienced software engineer specializing in web development.</td>
    </tr>
    <tr>
        <td>Alice Smith</td>
        <td>Project Manager</td>
        <td>Seasoned project manager with expertise in agile methodologies.</td>
    </tr>
    <tr>
        <td>Michael Johnson</td>
        <td>Data Analyst</td>
        <td>Skilled data analyst proficient in statistical analysis and data visualization.</td>
    </tr>
</table>

Dla skomplikówanych układów użyj CSS i stylów druku, aby zapewnić doskonałe renderowanie PDF. IronPDF obsługuje nowoczesne funkcje CSS3 dla zaawansowanych układów dokumentów.

Dłączego warto używać tabel do wyświetlania danych PDF?

Tabele dostarczają zorganizowanej, uporządkowanej informacji, która dobrze przekłada się na drukowane dokumenty. Zachowują spójność formatowania na różnych platformach i są czytelne w formacie PDF. Silnik renderujący IronPDF dobrze obsługuje układy tabel, zachowując granice, odstępy i wyrównanie. Dla zaawansowanego formatowania zapoznaj się z niestandardowymi marginesami do optymalizacji układu.

Jakie są powszechne kwestie stylizacyjne dotyczące wyników PDF?

Dla wyników PDF używaj zapytań medialnych specyficznych dla druku CSS, wartości w pikselach zamiast jednostek względnych i osadzonych czcionek dla spójnego renderowania. IronPDF obsługuje czcionki internetowe i ikonograficzne dla spójności marki. Rozważ przerwy stron dla dokumentów wielostronicowych i odpowiednie marginesy dla profesjonalnego wyglądu.

Jakie opcje renderowania mogę zastosować do moich PDF?

IronPDF zapewnia rozległe opcje renderowania. Dodaj nagłówki i stopki, ustaw niestandardowe rozmiary papieru, kontroluj orientację stron i dodaj znaki wodne. ChromePdfRenderer oferuje ponad 50 właściwości umożliwiających dostosowanie generowania plików PDF.

Jak radzić sobie z błędami podczas generowania PDF?

Implementuj obsługę błędów dla solidnego generowania PDF:

try
{
    var html = await RazorTemplateEngine.RenderAsync("Views/Home/Data.cshtml");
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(html, "./wwwroot");
    return Results.File(pdf.BinaryData, "application/pdf", "razorViewToPdf.pdf");
}
catch (Exception ex)
{
    // Log the error details
    IronPdf.Logging.Logger.Log($"PDF generation failed: {ex.Message}");
    return Results.Problem("Failed to generate PDF", statusCode: 500);
}

try
{
    var html = await RazorTemplateEngine.RenderAsync("Views/Home/Data.cshtml");
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(html, "./wwwroot");
    return Results.File(pdf.BinaryData, "application/pdf", "razorViewToPdf.pdf");
}
catch (Exception ex)
{
    // Log the error details
    IronPdf.Logging.Logger.Log($"PDF generation failed: {ex.Message}");
    return Results.Problem("Failed to generate PDF", statusCode: 500);
}

Imports IronPdf
Imports System.Threading.Tasks

Public Class PdfGenerator
    Public Shared Async Function GeneratePdfAsync() As Task(Of IResult)
        Try
            Dim html = Await RazorTemplateEngine.RenderAsync("Views/Home/Data.cshtml")
            Dim renderer = New ChromePdfRenderer()
            Dim pdf = renderer.RenderHtmlAsPdf(html, "./wwwroot")
            Return Results.File(pdf.BinaryData, "application/pdf", "razorViewToPdf.pdf")
        Catch ex As Exception
            ' Log the error details
            IronPdf.Logging.Logger.Log($"PDF generation failed: {ex.Message}")
            Return Results.Problem("Failed to generate PDF", statusCode:=500)
        End Try
    End Function
End Class

Kiedy powinienem włączyć szczegółowe logowanie?

Włącz szczegółowe logowanie podczas rozwoju i rozwiązywania problemów. Logowanie IronPDF dostarcza wgląd w renderowanie, pomagając zidentyfikować problemy z parsowaniem HTML, ładowaniem zasobów lub konfiguracją. Dla produkcji używaj niestandardowego logowania do integracji z infrastrukturą logowania aplikacji.

Na jakie inne problemy związane ze ścieżkami powinienem zwrócić uwagę?

Oprócz problemu ze ścieżką tyldy (~), upewnij się, że źródła obrazów używają ścieżek absolutnych lub prawidłowych odniesień względnych. Dla zewnętrznych zasobów używaj podstawowych adresów URL do zapewnienia prawidłowego ładowania zasobów. Dla obrazów z Azure Blob Storage zobacz osadzanie obrazów z Azure Blob Storage.

Jak statyczne zasoby wpływają na generowanie PDF?

Statyczne zasoby (CSS, JavaScript, obrazy) wpływają na wydajność i jakość generowania PDF. Upewnij się, że zasoby są dostępne podczas renderowania, używaj zoptymalizowanych obrazów i rozważ osadzanie krytycznego CSS inline dla szybszego renderowania. Dowiedz się o opóźnieniach renderowania i limitach czasowych dla treści z dużą ilością JavaScript.

Uruchom projekt, aby wygenerować dokument PDF.

Wynik w formacie PDF

Jak powinien wyglądać mój końcowy PDF?

Twój PDF powinien zachować formatowanie całego widoku Razor—struktury tabel, czcionki, kolory i układ. Powinien być odpowiednio dostosowany z czystymi marginesami i profesjonalnym wyglądem. Aby zweryfikować jakość wyników, użyj funkcji rasteryzacji IronPDF do podglądu stron jako obrazów.

Jak mogę rozwiązywać typowe problemy z renderowaniem PDF?

Typowe problemy to brakujące style, uszkodzone układy lub niekompletna treść. Włącz szczegółowe logowanie, zweryfikuj ścieżki zasobów i upewnij się, że HTML jest prawidłowo walidowany. Dla skomplikówanych układów użyj narzędzi do debugowania Chrome do podglądu HTML przed konwersją. Dla specyficznych problemów z renderowaniem użyj opóźnień WaitFor, aby zapewnić załadowanie treści przed renderowaniem.

Jakie są wymagania wstępne do uruchomienia przykładowego projektu?

Potrzebujesz Visual Studio 2019 lub nowszego z .NET 6.0 SDK lub wyższym. Projekt wymaga połączenia z internetem do przywrócenia pakietów NuGet. Przed uruchomieniem zaktualizuj klucz licencyjny IronPDF w Program.cs. Dla wdrożenia, przejrzyj przewodnik instalacji Windows dla dodatkowych wymagań.

Jak dostosować przykład do mojego przypadku użycia?

Przykład zapewnia podstawę dla twoich specyficznych potrzeb. Dodaj dynamiczne modele danych, implementuj buforowanie dla często generowanych PDF lub integruj z istniejącą autoryzacją. Dla zaawansowanych scenariuszy, eksploruj asynchroniczne generowanie PDF dla poprawy wydajności, lub zaimplementuj kompresję PDF do zmniejszenia rozmiaru plików. Dodaj podpisy cyfrowe dla autentyczności dokumentów lub ochronę hasłem dla wrażliwych dokumentów.