Visualizando PDFs no MAUI para C# .NET

Esta seção aborda como criar uma página de visualização de PDF, integrar o IronPDF Viewer e criar uma aba para ele em um aplicativo MAUI. Demonstramos isso com XAML e C# ContentPage. Escolha a abordagem que melhor se adapte ao seu estilo de desenvolvimento e aos requisitos do projeto.

Quais são os passos para adicionar uma página de visualizador?

1. Adicione uma nova página ao seu projeto clicando com o botão direito do mouse sobre o projeto e navegando até Add > New Item...

2. Navegue até a seção .NET MAUI. Para criar uma página XAML, selecione .NET MAUI ContentPage (XAML). Para um arquivo C#, selecione .NET MAUI ContentPage (C#). Dê ao seu arquivo o nome PdfViewerPage e clique em Add.

3. No arquivo XAML, adicione o seguinte código e salve:

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

5. Salve seu projeto, compile e execute. Você deverá ver abas no canto superior esquerdo, como mostrado abaixo. Clicar na aba "Visualizador de PDF" abre o Visualizador IronPDF . O visualizador oferece uma interface rica em recursos para interação com documentos PDF.

Ao iniciar o aplicativo, o IronPDF Viewer solicita ao usuário que abra um PDF por padrão. No entanto, ele pode abrir um PDF automaticamente na inicialização, o que melhora a experiência do usuário para aplicativos que precisam exibir documentos específicos imediatamente. Você pode carregar um PDF na inicialização de três maneiras: pelo nome do arquivo, por meio de uma matriz de bytes e por meio de um fluxo. Cada método oferece diferentes vantagens dependendo da sua fonte de dados e da arquitetura da aplicação.

Como faço para carregar um arquivo pelo nome?

Para carregar um PDF pelo nome do arquivo, especifique a origem do arquivo PDF na tag IronPdfView no arquivo XAML. Esta é a abordagem mais simples ao trabalhar com arquivos locais:

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

Da mesma forma, em 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

Isso exibe:

Esse controle detalhado sobre as opções da barra de ferramentas permite criar uma experiência de visualização que atenda aos requisitos do seu aplicativo. Por exemplo, você pode restringir o download em um visualizador de documentos seguro ou simplificar a interface para cenários básicos de visualização.