Viewing PDFs in MAUI for C# .NET

Bu bölümde, bir PDF Görüntüleyici sayfası oluşturmayı, IronPDF Görüntüleyici'yi entegre etmeyi ve bir MAUI uygulamasında bunun için bir sekme oluşturmayı öğreneceğiz. Bunu hem XAML hem de C# ContentPage ile nasıl yapacağımızı göstereceğiz.

Adımlar

1. Projenize sağ tıklayarak yeni bir sayfa ekleyin, ardından Add > New Item... adresine gidin.

2. .NET MAUI bölümüne gidin. Bir XAML sayfası oluşturmak için .NET MAUI ContentPage (XAML) öğesini seçin. C# dosyası için .NET MAUI ContentPage (C#)'yi seçin. Dosyanıza PdfViewerPage adını verin, ardından Add öğesini tıklayın.

3. XAML dosyasına aşağıdaki kodu ekleyin ve kaydedin:

:path=/static-assets/pdf/tutorials/pdf-viewing/pdf-viewing-xaml-1.xml

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

Bunun yerine bir C# ContentPage oluşturduysanız, aşağıdaki kodu ekleyin ve kaydedin:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-3.cs

using IronPdf.Viewer.Maui;

public class MainPage : ContentPage
{
    private readonly IronPdfView pdfView;

    public MainPage()
    {
        InitializeComponent();

        this.pdfView = new IronPdfView { Options = IronPdfViewOptions.All };

        Content = this.pdfView;
    }
}

Imports IronPdf.Viewer.Maui

Public Class MainPage
	Inherits ContentPage

	Private ReadOnly pdfView As IronPdfView

	Public Sub New()
		InitializeComponent()

		Me.pdfView = New IronPdfView With {.Options = IronPdfViewOptions.All}

		Content = Me.pdfView
	End Sub
End Class

4. AppShell.xaml dosyanıza aşağıdakileri ekleyin:

:path=/static-assets/pdf/tutorials/pdf-viewing/pdf-viewing-xaml-2.xml

<?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. Projenizi kaydedin, ardından derleyip çalıştırın. Aşağıda gösterildiği gibi sol üst köşede sekmeler görmelisiniz ve "PDF Viewer" sekmesine tıkladığınızda IronPDF Viewer açılmalıdır.

Uygulama başlarken, IronPDF Viewer varsayılan olarak kullanıcıdan bir PDF açmasını isteyecektir. Başlangıçta otomatik olarak bir PDF açması da mümkündür. Başlangıçta bir PDF yüklemenin üç yolu vardır: dosya adı ile, byte dizisi ile ve bir akış ile.

Dosya Adı ile Yükleme

Bir PDF dosyasını dosya adına göre yüklemek için, XAML dosyasındaki IronPdfView etiketinde PDF dosyasının kaynağını belirtebilirsiniz. Bunun bir örneği aşağıda gösterilmiştir:

:path=/static-assets/pdf/tutorials/pdf-viewing/pdf-viewing-xaml-3.xml

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>
    <ipv:IronPdfView Source="C:/path/to/my/example.pdf" />
</ContentPage>

IronPdfViewSource.FromFile

Alternatif olarak, C# LoadFromFilename() yöntemini kullanarak PDF'yi dosya adına göre yükleyebilirsiniz ContentPage:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-4.cs

// We assume an IronPdfView instance is created previously called pdfView
pdfView.Source = IronPdfViewSource.FromFile("C:/path/to/my/example.pdf");

' We assume an IronPdfView instance is created previously called pdfView
pdfView.Source = IronPdfViewSource.FromFile("C:/path/to/my/example.pdf")

IronPdfViewSource.FromBytes

Byte Dizisi ile Yükleme

Bazı kullanım durumları için bir PDF'nin byte dizisini yüklemek istenebilir. Bu, XAML'den mümkün değildir, ancak C# içinde mümkündür. Bunu, LoadFromByteArray() yöntemini kullanarak kolayca başarabilirsiniz. Bu yöntemin nasıl kullanılacağına dair bir örnek aşağıda gösterilmiştir:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-5.cs

pdfView.Source = IronPdfViewSource.FromBytes(File.ReadAllBytes("~/Downloads/example.pdf"));

pdfView.Source = IronPdfViewSource.FromBytes(File.ReadAllBytes("~/Downloads/example.pdf"))

IronPdfViewSource.FromStream

Akış ile Yükleme

Benzer şekilde, bazı kullanım durumlarında PDF'lerin bir akış üzerinden yüklenmesi daha istenebilir. Bu, XAML'den mümkün değildir, ancak C# içinde mümkündür. Bunu, LoadFromStream() yöntemini kullanarak kolayca başarabilirsiniz. Bu yöntemin nasıl kullanılacağına dair bir örnek aşağıda gösterilmiştir:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-6.cs

pdfView.Source = IronPdfViewSource.FromStream(File.OpenRead("~/Downloads/example.pdf"));

pdfView.Source = IronPdfViewSource.FromStream(File.OpenRead("~/Downloads/example.pdf"))

Option