Yapılandırma Seçenekleri Referansı

Yapılandırma Seçenekleri Referansı

Çoğu yükleme, kaydetme ve dönüştürme işlemi Aspose.PDF FOSS içinde .NET için bir *Options nesne kabul eder; bu nesne işlemin davranışını yapılandırır. LoadOptions and SaveOptions bu ailenin iki soyut köküdür: her format-özel yükleyici (HtmlLoadOptions, MdLoadOptions, TxtLoadOptions, SvgLoadOptions) şuradan türetilir LoadOptions, ve her format-özel yazar (PdfSaveOptions, HtmlSaveOptions, SvgSaveOptions) şuradan türetilir SaveOptions. Bu sayfa, ailenin nasıl bir araya geldiğini açıklar ve zaten … tarafından kapsanmayan seçenek sınıflarını belgeler Dönüştürme ve Optimizasyon kılavuz.

LoadOptions ile Belgeleri Yükleme

Her *LoadOptions alt sınıfı, LoadOptions temel sınıfından WarningHandler, WarningHandlerName, DisableFontLicenseVerifications ve LoadFormat öğelerini paylaşır, ardından kaynak formatına özgü özellikler ekler.

// HTML: resolve relative images/CSS against a base path
var htmlOptions = new HtmlLoadOptions("assets/");
htmlOptions.IsEmbedFonts = true;
using var htmlDoc = new Document("input.html", htmlOptions);

// Markdown: apply custom CSS while rendering to PDF
var mdOptions = new MdLoadOptions();
mdOptions.CssStyles = "body { font-family: sans-serif; }";
using var mdDoc = new Document("input.md", mdOptions);

// Plain text: control the rendered font size
var txtOptions = new TxtLoadOptions();
txtOptions.FontSize = 11;
using var txtDoc = Document.Open("input.txt", txtOptions);

// SVG: let the page size follow the artwork dimensions
var svgOptions = new SvgLoadOptions();
svgOptions.AdjustPageSize = true;
using var svgDoc = new Document("input.svg", svgOptions);

PdfSaveOptions ile PDF’ye Kaydetme

PdfSaveOptions, bir Document öğesini PDF olarak geri yazarken yazı tipi işleme ve geçici dosya yerleşimini kontrol eder. Ortak SaveOptions temel sınıfından CloseResponse, SaveFullPath, WarningHandler, CacheGlyphs ve SaveFormat öğelerini devralır.

using var doc = Document.Open("input.pdf");

var pdfOptions = new PdfSaveOptions();
pdfOptions.DefaultFontName = "Arial";
pdfOptions.TempPath = "temp/";

doc.Save("output.pdf", pdfOptions);

HTML ve SVG’ye Dışa Aktarma

HtmlSaveOptions ve SvgSaveOptions her ikisi de UnifiedSaveOptions‘den türetilir. Dönüşüm kılavuzunda ele alınan görüntü/yazı tipi/düzen kontrollerinin ötesinde, HtmlSaveOptions ayrıca belge çeşidini ve sayfalama stratejisini seçmenize izin verir, SvgSaveOptions ise tamamen kalıtılan SaveOptions/UnifiedSaveOptions üyelerine dayanır.

using var doc = Document.Open("input.pdf");

// Fixed-layout HTML5 output, split one file per page
var htmlOptions = new HtmlSaveOptions(HtmlDocumentType.Html5, fixedLayout: true);
htmlOptions.SplitIntoPages = true;
htmlOptions.ImageResolution = 150;
htmlOptions.Title = "Converted Document";
doc.Save("output.html", htmlOptions);

// SVG export configured through the shared SaveOptions members
var svgOptions = new SvgSaveOptions();
svgOptions.SaveFullPath = false;
doc.Save("output.svg", svgOptions);

Document.Convert ile Tek Adımda Dönüştürme

Document.Convert, kaynak LoadOptions ve hedef SaveOptions‘yi tek bir statik çağrıda kabul eder, böylece bir Document‘ı manuel olarak açıp, dönüştürüp ve yok etmeden formatlar arasında dönüşüm yapabilirsiniz.

var loadOptions = new HtmlLoadOptions();
var saveOptions = new PdfSaveOptions();

Document.Convert("input.html", loadOptions, "output.pdf", saveOptions);

Metin Çıkarma Seçenekleri

TextExtractionOptions, TextAbsorber‘in (ve TextDevice) çıkarılan metni nasıl biçimlendirdiğini kontrol eder; çıkarımı hangi absorber veya cihaz sınıfının yaptığına bağımlı değildir.

using var doc = Document.Open("input.pdf");

var extractionOptions = new TextExtractionOptions(TextFormattingMode.Raw);
extractionOptions.ScaleFactor = 1.0;
extractionOptions.IgnoreResourceFontErrors = true;

var absorber = new TextAbsorber(extractionOptions);
doc.Pages[1].Accept(absorber);

string text = absorber.Text;

OptimizationOptions ile Çıktıyı Optimize Etme

OptimizationOptions, dosya boyutunu azaltmak için ayrı, format bağımsız bir mekanizmadır. *SaveOptions sınıfı üzerinden değil, Document.OptimizeResources aracılığıyla uygulanır, bu yüzden herhangi bir kaydetme yolu ile birleştirilebilir.

using var doc = Document.Open("input.pdf");

var optimizationOptions = new OptimizationOptions();
optimizationOptions.RemoveUnusedObjects = true;
optimizationOptions.CompressObjects = true;
optimizationOptions.SubsetFonts = true;
optimizationOptions.ImageCompressionOptions.CompressImages = true;
optimizationOptions.ImageCompressionOptions.ImageQuality = 80;

doc.OptimizeResources(optimizationOptions);
doc.Save("optimized.pdf");

İpuçları ve En İyi Uygulamalar

• Her *LoadOptions ve *SaveOptions alt sınıfı WarningHandler/WarningHandlerName miras alır - kurtarılabilir tanı bilgilerini yakalamak için ikisini birlikte ayarlayın.
• Dosya yolları yerine akışlarla çalışırken, özellikle uzantı tabanlı format çıkarımına güvenmek yerine format-özgü *LoadOptions/*SaveOptions örneğini tercih edin.
• Manuel olarak bir Document açıp yeniden kaydetmek yerine tek seferlik dönüşümler için Document.Convert(srcFileName, loadOptions, dstFileName, saveOptions) kullanın.
• OptimizationOptions, *SaveOptions ailesinden bağımsızdır - hedef format ne olursa olsun çıktıyı küçültmek için OptimizeResources’yi Save’den önce çağırın.
• Aynı ayarlar birden çok belgeye uygulanıyorsa, her seferinde yeniden oluşturmak yerine tek bir seçenek örneğini birden çok belge arasında yeniden kullanın.

Sık Karşılaşılan Sorunlar

FAQ

LoadOptions ile SaveOptions arasındaki fark nedir?

LoadOptions, bir belgenin PDF dışı kaynak biçiminden (HTML, Markdown, metin, SVG) nasıl okunduğunu yapılandırır; SaveOptions, bir Document‘nin bir çıkış biçimine (PDF, HTML, SVG) nasıl yazıldığını yapılandırır. Her format-spesifik seçenek sınıfı tam olarak bu iki kökten birinden türetilir.

Yerel bir PDF açarken LoadOptions’ı belirtmem gerekiyor mu?

Hayır. Document.Open ve Document yapıcıları, yerel PDF girişi için düz bir dosya yolu veya akış kabul eder. *LoadOptions alt sınıfları yalnızca HTML, Markdown, metin veya SVG gibi PDF dışı bir kaynak biçimi içe aktarılırken gerekir.

Aynı SaveOptions örneğini birden fazla Save çağrısında yeniden kullanabilir miyim?

Evet. Bir seçenek örneği yalnızca düz bir yapılandırma nesnesidir; belge başına bir durum tutmaz, bu nedenle aynı PdfSaveOptions veya HtmlSaveOptions örneği, aynı ayarları paylaşan birden fazla belge için Save‘ye geçirilebilir.

OptimizationOptions, format-spesifik SaveOptions sınıflarından nasıl farklıdır?

OptimizationOptions, kaydetmeden ayrı bir adım olan Document.OptimizeResources tarafından tüketilir. Kullanılmayan nesneleri/akışları kaldırır ve görüntüleri yerinde yeniden sıkıştırır; ayrıca herhangi bir *SaveOptions alt sınıfı ile Save‘yi çağırmadan önce uygulanabilir.

Her kaynak/hedef formatının hem bir LoadOptions hem de bir SaveOptions sınıfı var mı?

Gerekli olarak simetrik değil. Örneğin, Markdown ve düz metin şu anda içe aktarma için MdLoadOptions/TxtLoadOptions sunuyor ancak eşleşen bir *SaveOptions karşılığı yok, bu da her formatın dönüşüm için hangi yönde desteklendiğini yansıtıyor.

API Reference Özet

Ayrıca Bakınız

• Dönüştürme ve Optimizasyon
• Aspose.PDF for .NET Enterprise Product
• Aspose.PDF for .NET — Enterprise Documentation