Przeglądanie PDF-ów w MAUI dla C# .NET

This article was translated from English: Does it need improvement?
Translated
View the article in English

Bezpośrednio przeglądaj PDF-y w aplikacji MAUI za pomocą IronPDF Viewer, który oferuje w pełni funkcjonalny komponent do przeglądania PDF z opcjami narzędziowymi do nawigacji, zoomu, wyszukiwania i drukowania w zaledwie jednej linii kodu.

Baner IronPDF .NET Maui PDF Viewer przedstawiający złożony dokument techniczny z wykresami i diagramami wyświetlanymi w przeglądarce

Aplikacje międzyplatformowe często muszą wyświetlać dokumenty PDF bezpośrednio w aplikacji. IronPDF Viewer pozwala osadzić funkcjonalność przeglądania PDF w aplikacji MAUI, umożliwiając przeglądanie dokumentów na platformach Windows i macOS.

IronPDF Viewer to komponent, który bazuje na bibliotece IronPDF, oferując kompleksowe rozwiązanie do manipulacji i przeglądania PDF. Zapewnia natywną integrację z aplikacjami .NET MAUI dla spójnej wydajności na różnych platformach.

Ten artykuł pokazuje, jak zintegrować IronPDF Viewer z aplikacją MAUI, aby umożliwić użytkownikom przeglądanie, zapisywanie i drukowanie PDF. Niezależnie od tego, czy tworzysz aplikacje dla przedsiębiorstw, systemy zarządzania dokumentami, czy oprogramowanie edukacyjne, ten przewodnik pomoże ci wdrożyć funkcje przeglądania PDF.

Szybki start: Przeglądanie PDF w MAUI za pomocą IronPDF

Zintegruj IronPDF z aplikacją MAUI i natychmiast zacznij przeglądać PDF-y. Ten fragment kodu pokazuje, jak utworzyć instancję IronPDF PdfViewer i załadować plik PDF do przeglądania.

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf
  2. Skopiuj i uruchom ten fragment kodu.

    new IronPdf.Viewer.Maui.PdfViewer { Source = "document.pdf" };
  3. Wdrożenie do testowania w środowisku produkcyjnym

    Rozpocznij używanie IronPDF w swoim projekcie już dziś z darmową wersją próbną

    arrow pointer


Jak pobrać i zainstalować bibliotekę IronPDF Viewer?

Jak zainstalować przez Menedżera Pakietów NuGet?

W programie Visual Studio kliknij prawym przyciskiem myszy swój projekt w eksploratorze rozwiązań i wybierz Manage NuGet Packages.... Następnie wyszukaj IronPdf.Viewer.Maui i zainstaluj najnowszą wersję w swoim środowisku. Szczegółowe informacje dotyczące instalacji znajdziesz w Przeglądzie Instalacji. Alternatywnie, otwórz konsolę NuGet Package Manager, przechodząc do Tools > NuGet Package Manager > Package Manager Console i wpisując następujące polecenie:

Install-Package IronPdf.Viewer.Maui

Pakiet IronPDF Viewer zawiera wszystkie niezbędne zależności do przeglądania PDF w aplikacjach MAUI. Używa tego samego silnika renderowania, co rdzenna biblioteka IronPDF do precyzyjnego wyświetlania dokumentów.

Jak zintegrować IronPDF Viewer z aplikacją MAUI?

Poniższe sekcje pokazują, jak zintegrować IronPDF Viewer z domyślną aplikacją MAUI. Proces integracji jest prosty i wymaga minimalnej konfiguracji.

Jakie ustawienia są wymagane przed integracją?

Przed dodaniem IronPDF Viewer do projektu MAUI upewnij się, że nie celuje w platformy iOS i Android. Obecnie IronPDF Viewer wspiera platformy biurkowe Windows i macOS. Sprawdź to, klikając prawym przyciskiem myszy plik projektu i wybierając Properties. Odznacz pola wyboru Target the iOS Platform i Target the Android platform, jeśli są zaznaczone. Aby zmiany weszły w życie, zapisz projekt po ich odznaczeniu i uruchom ponownie Visual Studio.

Właściwości projektu MAUI pokazujące obsługę platform iOS, Android i Windows w ramach środowiska .NET Framework 7.0

Po wyłączeniu platform iOS i Android przejdź do pliku MauiProgram.cs i dodaj następujący kod, aby zainicjować przeglądarkę:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-1.cs
using IronPdf.Viewer.Maui;

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            // other configuration options ...
            .ConfigureIronPdfView(); // configure the viewer on app start-up

        return builder.Build();
    }
}
Imports IronPdf.Viewer.Maui

Public Module MauiProgram
	Public Function CreateMauiApp() As MauiApp
		Dim builder = MauiApp.CreateBuilder()
		builder.UseMauiApp(Of App)().ConfigureIronPdfView() ' configure the viewer on app start-up

		Return builder.Build()
	End Function
End Module
$vbLabelText   $csharpLabel

Domyślnie IronPDF Viewer wyświetla baner w prawym dolnym rogu widoku. Aby usunąć ten baner i odblokować wszystkie funkcje, dodaj swój klucz licencyjny IronPDF (lub Iron Suite) do ConfigureIronPdfViewer:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-2.cs
.ConfigureIronPdfView("YOUR-LICENSE-KEY");
.ConfigureIronPdfView("YOUR-LICENSE-KEY")
$vbLabelText   $csharpLabel

Szczegółowe informacje na temat uzyskiwania i stosowania kluczy licencyjnych znajdziesz w Przewodniku po kluczach licencyjnych.

Jak dodać stronę przeglądarki PDF?

Ta sekcja obejmuje, jak utworzyć stronę przeglądarki PDF, zintegrować IronPDF Viewer i utworzyć dla niej zakładkę w aplikacji MAUI. Ilustrujemy to zarówno za pomocą XAML, jak i C# ContentPage. Wybierz podejście, które najlepiej pasuje do twojego stylu rozwoju i wymagań projektu.

Jakie są kroki, aby dodać stronę przeglądarki?

  1. Dodaj nową stronę do projektu, klikając prawym przyciskiem myszy na projekt, a następnie przejdź do Add > New Item... Menu Dodaj w programie Visual Studio zawierające opcje Nowy element, odwołania i komponenty projektu do tworzenia aplikacji MAUI

  2. Przejdź do sekcji .NET MAUI. Aby utworzyć stronę XAML, wybierz .NET MAUI ContentPage (XAML). W przypadku pliku C# wybierz .NET MAUI ContentPage (C#). Nadaj plikowi nazwę PdfViewerPage, a następnie kliknij Add. Okno dialogowe Visual Studio

  3. W pliku XAML dodaj następujący kod i zapisz:

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>

<?xml version="1.0" encoding="UTF-8" ?>
<Shell ...
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    ...>
  <TabBar x:Name="AppTabBar">
      <Tab Title="Home">
        <ShellContent ContentTemplate="{DataTemplate local:MainPage}" Route="MainPage"/>
      </Tab>
      <Tab Title="PDF Viewer">
        <ShellContent ContentTemplate="{DataTemplate local:PdfViewerPage}" Route="PDFViewer"/>
    </Tab>
  </TabBar>
</Shell>

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>

<?xml version="1.0" encoding="UTF-8" ?>
<Shell ...
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    ...>
  <TabBar x:Name="AppTabBar">
      <Tab Title="Home">
        <ShellContent ContentTemplate="{DataTemplate local:MainPage}" Route="MainPage"/>
      </Tab>
      <Tab Title="PDF Viewer">
        <ShellContent ContentTemplate="{DataTemplate local:PdfViewerPage}" Route="PDFViewer"/>
    </Tab>
  </TabBar>
</Shell>
XML
  1. Zapisz projekt, a następnie zbuduj i uruchom. Powinieneś zobaczyć zakładki w lewym górnym rogu, jak pokazano poniżej. Kliknięcie zakładki "PDF Viewer" otwiera IronPDF Viewer. Przeglądarka oferuje bogaty w funkcje interfejs do interakcji z dokumentami PDF.

Domyślny interfejs przeglądarki IronPDF z ciemnym motywem, pokazujący obszar przesyłania plików i przycisk Przeglądaj pliki

Jak załadować PDF przy starcie?

Podczas uruchamiania aplikacji IronPDF Viewer domyślnie wyświetla monit o otwarcie PDF-a. Jednakże, może otworzyć PDF automatycznie przy starcie, co poprawia doświadczenie użytkownika w aplikacjach, które muszą natychmiast wyświetlać konkretne dokumenty. Możesz załadować PDF przy starcie na trzy sposoby: po nazwie pliku, przez tablicę bajtów i przez strumień. Każda metoda oferuje różne zalety, w zależności od źródła danych i architektury aplikacji.

Jak załadować przez nazwę pliku?

Aby załadować plik PDF według nazwy, należy określić źródło pliku PDF w tagu IronPdfView w pliku XAML. Jest to najprostsze podejście podczas pracy z plikami lokalnymi:


<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>

<ipv:IronPdfView x:Name="pdfView" Options="Thumbs, Open"/>

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>

<ipv:IronPdfView x:Name="pdfView" Options="Thumbs, Open"/>
XML

Podobnie w języku C#:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-8.cs
pdfView.Options = IronPdfViewOptions.Thumbs | IronPdfViewOptions.Open;
pdfView.Options = IronPdfViewOptions.Thumbs Or IronPdfViewOptions.Open
$vbLabelText   $csharpLabel

To wyświetla:

Pasek narzędzi przeglądarki IronPDF z ikoną menu, logo i przyciskiem

Ta precyzyjna kontrola nad opcjami paska narzędzi pozwala na stworzenie doświadczenia przeglądania, które odpowiada wymaganiom twojej aplikacji. Na przykład, możesz ograniczyć pobieranie w bezpiecznej przeglądarce dokumentów lub uprościć interfejs dla podstawowych scenariuszy przeglądania.

Wnioski

Ten poradnik obejmował, jak zintegrować IronPDF Viewer z aplikacją MAUI i dostosować jego pasek narzędzi do twoich potrzeb. IronPDF Viewer zapewnia potężne doświadczenie przeglądania PDF, które bezproblemowo integruje się z twoimi aplikacjami .NET MAUI przy użyciu minimalnej ilości kodu.

Elastyczność przeglądarki w ładowaniu PDF-ów z różnych źródeł (plików, tablic bajtów i strumieni) czyni ją odpowiednią dla wielu aplikacji, od prostych przeglądarek dokumentów po skomplikówane systemy zarządzania dokumentami. Połączona z rozległymi opcjami personalizacji paska narzędzi, możesz stworzyć dokładne doświadczenie przeglądania, jakiego potrzebują twoi użytkownicy.

Ta przeglądarka jest częścią naszego produktu IronPDF, który obejmuje również potężne możliwości generacji PDF, edycji i manipulacji dokumentami. Jeśli chcesz zgłosić zapotrzebowanie na funkcję lub masz jakiekolwiek ogólne pytania dotyczące IronPDF Viewer (lub IronPDF), prosimy skontaktować się z naszym zespołem wsparcia. Z przyjemnością ci pomożemy.

Dla bardziej zaawansowanych operacji PDF, zapoznaj się z naszym obszernym przewodnikiem przeglądania PDF lub dowiedz się, jak stosować klucze licencyjne, aby w pełni wykorzystać potencjał IronPDF w swoich aplikacjach.

Często Zadawane Pytania

Co to jest IronPDF Viewer dla .NET MAUI?

IronPDF Viewer to pełnoprawny komponent przeglądania PDF, który umożliwia osadzenie funkcjonalności przeglądania PDF bezpośrednio w aplikacjach MAUI. Zapewnia opcje narzędzi dla nawigacji, zoomu, wyszukiwania i drukowania i można go zaimplementować za pomocą jednej linii kodu. Przeglądarka bazuje na bibliotece IronPDF, oferując kompleksowe możliwości manipulacji i przeglądania PDF.

Jakie platformy obsługuje IronPDF Viewer w aplikacjach MAUI?

IronPDF Viewer zapewnia natywną integrację z aplikacjami .NET MAUI i wspiera przeglądanie PDF na różnych platformach, zarówno na Windows, jak i macOS, gwarantując stałe działanie w tych systemach operacyjnych.

Jak zainstalować IronPDF Viewer w moim projekcie MAUI?

Możesz zainstalować IronPDF Viewer za pośrednictwem Menedżera Pakietów NuGet w Visual Studio, wyszukując 'IronPdf.Viewer.Maui' i instalując najnowszą wersję. Alternatywnie, możesz użyć konsoli Menedżera Pakietów z poleceniem 'Install-Package IronPdf.Viewer.Maui'. Pakiet zawiera wszystkie niezbędne zależności do przeglądania PDF w aplikacjach MAUI.

Jak szybko mogę wdrożyć przeglądanie PDF w mojej aplikacji MAUI?

IronPDF Viewer pozwala osadzić w pełni funkcjonalną przeglądarkę PDF za pomocą zaledwie jednej linii kodu: new IronPdf.Viewer.Maui.PdfViewer { Source = "document.pdf" };. Dzięki temu dodanie możliwości przeglądania PDF do Twojej aplikacji MAUI jest niezwykle szybkie.

Jakie funkcje oferuje pasek narzędzi przeglądarki PDF?

Pasek narzędzi IronPDF Viewer oferuje kompleksowe funkcje, w tym kontrolki nawigacyjne do przemieszczania się między stronami, funkcje zoomu do regulacji rozmiaru widoku dokumentu, możliwości wyszukiwania tekstu w PDF oraz opcje drukowania dokumentów bezpośrednio z aplikacji MAUI.

Czy mogę ładować pliki PDF z różnych źródeł w IronPDF Viewer?

Tak, IronPDF Viewer obsługuje ładowanie plików PDF z wielu źródeł, w tym bezpośrednio z ścieżek plików, tablic bajtów i strumieni. Ta elastyczność pozwala na wyświetlanie plików PDF z pamięci lokalnej, pamięci wewnętrznej lub zasobów sieciowych w aplikacji MAUI.

Czy IronPDF Viewer nadaje się do zastosowań w przedsiębiorstwie?

IronPDF Viewer jest idealny do budowy aplikacji korporacyjnych, systemów zarządzania dokumentami i oprogramowania edukacyjnego. Używa tego samego silnika renderowania co rdzeń biblioteki IronPDF, zapewniając dokładne wyświetlanie dokumentów i profesjonalną jakość przeglądania PDF odpowiednią dla aplikacji o kluczowym znaczeniu biznesowym.

Jordi Bardia
Inżynier oprogramowania
Jordi jest najbardziej biegły w Pythonie, C# i C++. Kiedy nie wykorzystuje swoich umiejętności w Iron Software, programuje gry. Dzieląc odpowiedzialność za testowanie produktów, rozwój produktów i badania, Jordi wnosi ogromną wartość do ciągłej poprawy produktów. Różnorodne doświadczenia ...
Czytaj więcej
Gotowy, aby rozpocząć?
Nuget Pliki do pobrania 18,926,724 | Wersja: 2026.5 just released
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu? PM > Install-Package IronPdf
Uruchom przykład i zobacz, jak Twój kod HTML zamienia się w plik PDF.