LoadFromMappedFile

Belge yönetimi, Performans, Dosya girdisi

Açıklama

Yerel bir PDF'yi sınırlı salt okunur eşlenen bir görünüm üzerinden yükler ve seçer; böylece büyük, ertelenmiş nesne ve akış okumaları, kaynağın tamamını bellekte tutmadan işletim sistemi dosya sayfalarını yeniden kullanabilir

Sözdizimi

Delphi

Function TPDFlib.LoadFromMappedFile(Const FileName, Password: WideString;
  WindowSize: Int64= 0; Options: Integer= 0): Integer;

Parametreler

FileNameYerel PDF'nin yolu
PasswordPDF'yi açmak için kullanılan parola; şifrelenmemiş belge için boş dize
WindowSizeİstenen eşlenen görünüm boyutu, bayt cinsinden; sıfır 64 MiB seçer, işletim sisteminin ayırma granülaritesinin altındaki değerler bu granülariteye yükseltilir ve 1 GiB üzerindeki değerler sınırlanır
OptionsSıfır, salt okunur bir dosya akışına geri dönüşe izin verir; PDF_MAPPED_FILE_REQUIRE_MAPPING ise etkin bir eşlenen görünüm yoksa başarısız olur

Dönüş değerleri

0Bağımsız değişkenler geçersizdi, dosya açılamadı, gereken eşleme kullanılamadı veya PDF yüklenemedi; LastErrorCode değerini inceleyin
1Belge yüklendi ve seçildi

Açıklamalar

Windows derlemeleri bir salt okunur görünüm tutar ve ayırma granülaritesi sınırlarında talep üzerine yeniden eşler; diğer platformlar ve eşleme başarısızlıkları, eşleme gerekli olmadıkça normal bir salt okunur dosya akışı üzerinden aynı mutlak okuma sözleşmesini kullanır

Varsayılan 64 MiB görünüm, adres alanı kullanımını kaynak boyutundan bağımsız sınırlar ve büyük yerel dosyalara seyrek erişim için uygundur; daha küçük bir görünüm, daha fazla yeniden eşleme pahasına yerleşik adres alanını azaltabilir

Mutlak nesne dilimi okumaları, konumsal akış imlecini değiştirmeden geçerli görünümden ayrıştırıcıya ait depolamaya doğrudan kopyalar; yeniden eşleme görünüm adreslerini geçersiz kıldığından bu, kalıcı bir sıfır kopya işaretçi API'si değildir

Kaynak, yüklenen belge kaldırılana dek açık kalır ve kaydetme veya ertelenmiş ayıklama onu okumayı sürdürebilir

OnPassword atanmışsa reddedilen her parola yeniden denemesi yeni eşlenmiş bir akış ve ayrıştırıcı durumu alır

Eşlemenin etkin olup olmadığını doğrulamak ve geçerli görünüm ile okuma istatistiklerini incelemek için GetMappedFileInfo kullanın