Viewing PDFs in MAUI for C# .NET

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

IronPDF Viewer Banner

Çapraz platform geliştirme çağında, kullanıcılarınıza uygulamanız içerisinde doğrudan PDF belgelerini görüntüleme yeteneği sağlamak sadece bir kolaylık değil, bir gerekliliktir. IronPDF Görüntüleyici ile PDF görüntüleme işlevselliğini MAUI uygulamanıza ekleyebilirsiniz.

Bu makalede, MAUI uygulaması içinde IronPDF Görüntüleyici'yı entegre ederek, kullanıcıların PDF'leri görüntülemesine, kaydetmesine ve yazdırmasına nasıl olanak tanıyacağımızı öğreneceğiz.

Hızlı Başlangıç: IronPDF Görüntüleyici'yi MAUI'de Uygulama

MAUI uygulamanıza IronPDF Görüntüleyici'yi entegre etmeye başlamanız için yalnızca birkaç kod satırı yeterlidir. Bu hızlı kılavuz, IronPDF'nin güçlü kütüphanesini kullanarak PDF dosyasını zahmetsizce nasıl yükleneceğini gösterir. Uygulamalarını sorunsuz PDF görüntüleme yetenekleri ile geliştirmek için hevesli geliştiriciler için ideal olan bu yaklaşım, kullanımı kolaylık ve hızlı uygulama vurgular. IronPDF Görüntüleyici'yi başlatın ve uygulamanızda kolay PDF görüntüleme sağlamak için PDF'nizi yükleyin.

  1. NuGet Paket Yöneticisi ile https://www.nuget.org/packages/IronPdf yükleyin

    PM > Install-Package IronPdf
  2. Bu kod parçasını kopyalayıp çalıştırın.

    var viewer = new IronPdf.Viewer.Maui.PdfViewer { Source = "document.pdf" };
  3. Canlı ortamınızda test etmek için dağıtın

    Bugün projenizde IronPDF kullanmaya başlayın ücretsiz deneme ile

    arrow pointer

Visual Studio - NuGet Paket Yöneticisi

Visual Studio'da, proje gezginindeki projenize sağ tıklayın ve Manage NuGet Packages... seçeneğini seçin. Buradan, IronPdf.Viewer.Maui u aratabilir ve en son sürümünü çözümünüze yükleyebilirsiniz. Alternatif olarak, Tools > NuGet Package Manager > Package Manager Console üzerinden NuGet Paket Yöneticisi konsolunu açabilir ve aşağıdaki komutu girebilirsiniz:

Install-Package IronPdf.Viewer.Maui

IronPDF Viewer'ı MAUI Uygulamasına Entegre Et

Aşağıdaki bölümlerde, IronPDF Viewer'ı varsayılan bir MAUI uygulamasına nasıl entegre edeceğimizi göstereceğiz.

Kurulum

IronPDF Viewer'ı MAUI projenize eklemeden önce, hedef platformu iOS ve Android olmadığından emin olun. Bunu kontrol etmek için proje dosyasına sağ tıklayıp Özellikler i seçebilirsiniz. iOS Platformunu Hedefleyin ve Android Platformunu Hedefleyin onay kutularını zaten işaretli değillerse işaretlemeyi kaldırın. Bu değişikliğin başarıyla uygulanabilmesi için, işaretlemeyi kaldırdıktan sonra projeyi kaydetmeniz ve Visual Studio'yu yeniden başlatmanız gerekebilir.

Özellikler Ekranı

iOS ve Android platformlarını hedef almaktan çıkardıktan sonra MauiProgram.cs dosyanıza gidin ve görüntüleyiciyi başlatmak için aşağıdaki kodu ekleyin:

: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

Varsayılan olarak, IronPDF Viewer görünümün sağ alt köşesinde bir afiş gösterecektir. Bu görüntüyü kaldırmak için, IronPDF (veya Iron Suite) lisans anahtarınızı ConfigureIronPdfViewer içine şöyle ekleyin:

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

PDF Görüntüleyici Sayfası Ekleyin

Bu bölümde, bir PDF Görüntüleyici sayfası oluşturmayı, IronPDF Viewer'ı entegre etmeyi ve bir MAUI uygulamasında bunun için bir sekme oluşturmayı öğreneceğiz. Bunu hem bir 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 Yeni Öğe Ekle

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

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

Bunun yerine 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
$vbLabelText   $csharpLabel
  1. AppShell.xaml dosyanıza aşağıdakini 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>
XML
  1. Projenizi kaydedin, ardından derleyin ve çalıştırın. Aşağıda gösterildiği gibi sol üst köşede sekmeler görmelisiniz ve "PDF Viewer" sekmesine tıklamak IronPDF Viewer'ı açmalıdır.

IronPDF Viewer Varsayılan

Başlangıçta Bir PDF Yükleyin

Uygulamanın başlatılması sırasında, IronPDF Viewer varsayılan olarak kullanıcıdan bir PDF açmasını isteyecektir. Başlangıçta otomatik olarak bir PDF açmak da mümkündür. Başlangıçta bir PDF yüklemenin üç yolu vardır: bir dosya adı, bir bayt dizisi aracılığıyla ve bir akış aracılığıyla.

Dosya Adı İle Yükle

Bir PDF'i dosya adıyla yüklemek için, XAML dosyasındaki IronPdfView etiketine 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>
XML

Alternatif olarak, bir C# ContentPage içinde IronPdfViewSource.FromFile metodunu kullanarak PDF'i dosya adıyla yükleyebilirsiniz:

: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")
$vbLabelText   $csharpLabel

Bayt Dizisi ile Yükle

Bazı kullanım durumları için bir PDF'nin bir bayt dizisini yüklemek arzu edilebilir olabilir. Bu, XAML'den mümkün değildir, ancak C#'ta mümkündür. Bunu sadece IronPdfViewSource.FromBytes metodunu kullanarak başarabilirsiniz. Bu yöntemi nasıl kullanabileceğinizi gösteren 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"))
$vbLabelText   $csharpLabel

Akış ile Yükle

Benzer şekilde, bazı kullanım durumlarında PDF'lerin bir akış aracılığıyla yüklenmesi daha arzu edilebilir olabilir. Bu, XAML'den mümkün değildir, ancak C#'ta mümkündür. Bunu sadece IronPdfViewSource.FromStream metodunu kullanarak başarabilirsiniz. Bu yöntemi nasıl kullanabileceğinizi gösteren 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"))
$vbLabelText   $csharpLabel

Araç Çubuğunu Yapılandır

IronPDF Viewer ile araç çubuğunda hangi seçeneklerin gösterileceğini seçebilirsiniz. Mevcut seçenekler şunlardır:

  • Küçük resim görünümü
  • Dosya adı görüntüleme
  • Metin arama
  • Sayfa numarası navigasyonu
  • Yakınlaştırma
  • Genişliğe sığdır
  • Yüksekliğe sığdır
  • Saat yönünde döndür
  • Saat yönünün tersine döndür
  • Dosya aç
  • Dosya indir
  • Dosyayı yazdır
  • Açıklamaları göster
  • İki sayfa görüntüleme

Varsayılan olarak, IronPDF Viewer aşağıda gösterilen araç çubuğunu gösterecektir:

Varsayılan Araç Çubuğu

Varsayılan görünümde, dosya adı görüntüleme, metin arama ve saat yönünün tersine döndürme seçenekleri devre dışıdır. Her şeyi göstermek için, XAML'deki IronPdfView etiketinin Option parametresini All olarak ayarlayın:

:path=/static-assets/pdf/tutorials/pdf-viewing/pdf-viewing-xaml-4.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" Options="All"/>
</ContentPage>
XML

Aynısını C#'ta gerçekleştirebilirsiniz:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-7.cs
pdfView.Options = IronPdfViewOptions.All;
pdfView.Options = IronPdfViewOptions.All
$vbLabelText   $csharpLabel

Aşağıdaki görüntülenecektir:

Tüm Araç Çubuğu

Hiçbir şey göstermek istemiyorsanız, seçeneği None olarak ayarlayın. Araç çubuğu, Options bu şekilde ayarlandığında görünmeyecek:

Araç Çubuğu Yok

Hangi belirli seçeneklerin görüntülenmesini istediğinizi seçebilirsiniz. Örneğin, yalnızca küçük resmi ve dosya açma seçeneklerini göstermek istiyorsanız, XAML'deki IronPdfView parametresinin Options değerini aşağıdaki gibi değiştirin:

:path=/static-assets/pdf/tutorials/pdf-viewing/pdf-viewing-xaml-5.xml
<ipv:IronPdfView x:Name="pdfView" Options="Thumbs, Open"/>
XML

Benzer şekilde, C#'ta:

: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

Sonuç

Bu eğiticide, IronPDF Viewer'ı bir MAUI uygulamasına nasıl entegre edeceğimizi ve araç çubuğunu ihtiyaçlarınıza en iyi şekilde uyacak şekilde özelleştirmeyi öğrendik.

Bu görüntüleyici IronPDF ürünümüzle birlikte gelir. IronPDF Viewer (veya IronPDF) ile ilgili bir özellik talebi yapmak veya genel sorularınızla ilgili olarak destek ekibimizle iletişime geçebilirsiniz. Sizlere yardimci olmaktan memnuniyet duyariz.

Sıkça Sorulan Sorular

C# kullanarak bir MAUI uygulamasında PDF'leri nasıl görüntüleyebilirim?

C# kullanarak bir MAUI uygulamasında PDF'leri görüntülemek için IronPDF Görüntüleyici kütüphanesini entegre edebilirsiniz. Bu, kütüphaneyi Visual Studio'da NuGet aracılığıyla kurmayı ve projenizdeki PDF görüntüleme özelliklerini etkinleştirmek üzere yapılandırmayı içerir.

Bir MAUI uygulamasında bir PDF Görüntüleyici entegre etme süreci nedir?

Bir MAUI uygulamasında bir PDF Görüntüleyici entegre etmek, NuGet Paket Yöneticisi kullanılarak IronPDF Görüntüleyici kütüphanesini kurmayı ve MauiProgram.cs ile XAML veya C# ContentPage kullanarak projenizde görüntüleyiciyi ayarlamayı gerektirir.

IronPDF Görüntüleyici bir MAUI projesinde iOS ve Android platformlarında kullanılabilir mi?

Şu anda, IronPDF Görüntüleyici, iOS ve Android platformlarını hedeflemeyen MAUI projeleri için tasarlanmıştır. Masaüstü ortamlarına hedefleyen projelerde en iyi şekilde kullanılır.

MAUI projemde uygulama başlangıcında bir PDF dosyasını nasıl yüklerim?

MAUI uygulamanızda IronPdfViewSource.FromFile, FromBytes, veya FromStream gibi IronPDF Görüntüleyici yöntemlerini kullanarak başlangıçta bir PDF dosyasını yükleyebilirsiniz.

IronPDF Görüntüleyici için araç çubuğu yapılandırma seçenekleri nelerdir?

IronPDF Görüntüleyici araç çubuğu, küçük resim görünümü, metin arama, sayfa gezinme, yakınlaştırma, döndürme ve dosya işlemleri gibi seçenekleri içerecek şekilde özelleştirilebilir. Tüm seçenekleri, hiçbirini veya yalnızca belirli araçları gereksinimlerinize göre gösterecek şekilde ayarlayabilirsiniz.

PDF Görüntüleyici araç çubuğunu belirli araçları göstermek üzere nasıl özelleştirebilirim?

'Options' parametresini XAML veya C# kodunuzda, 'ThumbnailView,OpenFile' gibi yalnızca istenen seçenekleri içerecek şekilde ayarlayarak araç çubuğunu belirli araçları gösterecek şekilde özelleştirin.

IronPDF Görüntüleyicide araç çubuğunu gizlemek mümkün mü?

Evet, 'Options' parametresini 'None' olarak ayarlayarak araç çubuğunu gizleyebilir ve izleyici arayüzünden kaldırabilirsiniz.

Bir MAUI uygulamasında PDF render etme sorunlarına nasıl çözüm bulabilirim?

Bir MAUI uygulamasında PDF render etme sorunlarıyla karşılaşırsanız, IronPDF kütüphanesinin düzgün bir şekilde kurulduğundan ve yapılandırıldığından emin olun. Ayrıca, platforma özgü kısıtlamaları kontrol edin veya IronPDF'nin teknik ekibinden destek alın.

MAUI uygulamalarında IronPDF Görüntüleyicinin entegrasyonu için desteği nereden alabilirim?

MAUI uygulamalarında IronPDF Görüntüleyicinin entegrasyonu ile ilgili herhangi bir yardım veya özellik talebi için IronPDF'nin resmi web sitesi aracılığıyla destek ekibine ulaşabilirsiniz.

IronPDF Görüntüleyici, .NET 10 projeleriyle tamamen uyumlu mu?

Evet. IronPDF, MAUI uygulamaları için Görüntüleyici bileşeni de dahil olmak üzere tüm ana ürün hatlarında .NET 10'u destekler. IronPDF Görüntüleyici paketi, net10.0-windows ve net10.0-maccatalyst gibi hedef çerçevelerle uyumludur ve geliştiricilerin .NET 10 masaüstü tabanlı projelerinde PDF görüntüleme işlevselliğini gömmesine olanak tanır.

Curtis Chau
Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında lisans derecesine sahiptir (Carleton Üniversitesi) ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirme üzerine uzmanlaşmıştır. Kullanıcı dostu ve estetik açıdan hoş arayüzler tasarlamaya tutkuyla bağlı olan Curtis, modern çerç...

Daha Fazlasını Oku
Başlamaya Hazır mısınız?
Nuget Indirmeler 18,332,619 | Sürüm: 2026.4 yeni yayınlandı
Still Scrolling Icon

Hala Kaydiriyor musunuz?

Hızlı bir kanit mi istiyorsunuz? PM > Install-Package IronPdf
bir örnek çalıştır HTML'nizin PDF olduğunu izleyin.