Viewing PDFs in MAUI for C# .NET

Ç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.
-
NuGet Paket Yöneticisi ile https://www.nuget.org/packages/IronPdf yükleyin
PM > Install-Package IronPdf -
Bu kod parçasını kopyalayıp çalıştırın.
var viewer = new IronPdf.Viewer.Maui.PdfViewer { Source = "document.pdf" }; -
Canlı ortamınızda test etmek için dağıtın
Bugün projenizde IronPDF kullanmaya başlayın ücretsiz deneme ile
Minimal Is Akisi (5 adimda)
- IronPDF Görüntüleyici kütüphanesini indirin ve yükleyin
- IronPDF Görüntüleyici'yi MAUI Uygulamasına Entegre Edin
- XAML veya C# ContentPage ekleyerek bir PDF görüntüleyici sayfası ekleyin
- Başlangıçta bir PDF'yi dosya adı, Byte Dizisi ve Akış ile yükleyin
- Araç çubuğunu yapılandır
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.

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
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")
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
-
Projenize sağ tıklayarak yeni bir sayfa ekleyin, ardından
Add > New Item...adresine gidin
-
.NET MAUIbö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ındanAddtıklayın.
- 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 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
- 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>
- 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.

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>
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")
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"))
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"))
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 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>
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
Aşağıdaki görüntülenecektir:

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:

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

