Jak konwertować widoki Razor na PDF bez interfejsu graficznego w C

Dlaczego należy użyć Razor.Templating.Core zamiast IronPdf.Extensions.Razor?

Razor.Templating.Core zapewnia prawdziwe renderowanie bez interfejsu—konwertuje widoki Razor na HTML bez kontekstu sieciowego lub okna przeglądarki. To pasuje do usług w tle, aplikacji konsolowych lub środowisk bez interfejsu użytkownika. IronPdf.Extensions.Razor wymaga kontekstu sieciowego 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. Należy użyć tego podejścia w usługach w tle, funkcjach Azure lub aplikacjach konsolowych. Więcej informacji zawiera artykuł wdrażanie IronPDF na Azure.

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 ma zostać wyrenderowany 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 skomplikowanych 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.

Dlaczego 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 do dostosowania generacji 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 należy włączyć szczegółowe logowanie?

Szczegółowe logowanie należy włączyć podczas tworzenia aplikacji i rozwiązywania problemów. Logowanie IronPDF dostarcza wglądu w renderowanie, pomagając zidentyfikować problemy z parsowaniem HTML, ładowaniem zasobów lub konfiguracją. W środowisku produkcyjnym należy korzystać z niestandardowego logowania do integracji z infrastrukturą logowania aplikacji.

Na jakie inne problemy związane ze ścieżkami należy 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?

Wygenerowany 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, należy użyć 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 skomplikowanych 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?

Wymagany jest Visual Studio 2019 lub nowszy z .NET 6.0 SDK lub wyższym. Projekt wymaga połączenia z internetem do przywracania pakietów NuGet. Przed uruchomieniem należy zaktualizować klucz licencyjny IronPDF w Program.cs. Przy wdrożeniu warto przejrzeć przewodnik instalacji Windows.

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

Przykład stanowi podstawę do rozbudowy. Można dodać dynamiczne modele danych, zaimplementować buforowanie dla często generowanych PDF lub zintegrować z istniejącą autoryzacją. W zaawansowanych scenariuszach warto zbadać asynchroniczne generowanie PDF w celu poprawy wydajności lub zaimplementować kompresję PDF do zmniejszenia rozmiaru plików. Można też dodać podpisy cyfrowe lub ochronę hasłem dla wrażliwych dokumentów.