LoadFromMappedFile
Управление на документи, производителност, файлов вход
Описание
Зарежда и избира локален PDF чрез ограничен картуван изглед само за четене, позволявайки големи отложени четения на обекти и потоци да преизползват файловите страници на операционната система, без да задържа пълния източник в паметта
Синтаксис
Delphi
Function TPDFlib.LoadFromMappedFile(Const FileName, Password: WideString;
WindowSize: Int64= 0; Options: Integer= 0): Integer;Параметри
| FileName | Пътят на локалния PDF |
|---|---|
| Password | Паролата за отваряне на PDF или празен низ за нешифрован документ |
| WindowSize | Заявеният размер на картувания изглед в байтове; нула избира 64 MiB, стойности под грануларността на заделяне на операционната система се повишават до тази грануларност, а стойности над 1 GiB се ограничават |
| Options | Нула допуска резервен вариант с файлов поток само за четене, докато PDF_MAPPED_FILE_REQUIRE_MAPPING се проваля, освен ако картуван изглед не е активен |
Връщани стойности
| 0 | Аргументите бяха невалидни, файлът не можа да бъде отворен, изискваното картиране не беше налично или PDF не можа да бъде зареден; проверете LastErrorCode |
|---|---|
| 1 | Документът беше зареден и избран |
Бележки
Windows изгражданията задържат един изглед само за четене и го прекарат по поискане на граници с грануларност на заделяне; другите платформи и неуспешните карирания използват същия договор за абсолютно четене върху обикновен файлов поток само за четене, освен ако картирането не е изискваноИзгледът по подразбиране от 64 MiB ограничава използването на адресното пространство независимо от размера на източника и е подходящ за рядък достъп до големи локални файлове; по-малък изглед може да намали resident адресното пространство за сметка на повече повторни картиранияАбсолютни четения на срезове от обекти копират директно от текущия изглед в хранилище, притежавано от анализатора, без да променят позиционния курсор на потока; това не е устойчив API с указатели без копиране, защото повторното картиране обезсилва адресите на изгледаИзточникът остава отворен, докато зареденият документ бъде премахнат, а записът или отложеното извличане могат да продължат да го четатАко
OnPassword е зададен, всяко отхвърлено повторение на парола получава свеж картуван поток и състояние на анализатораИзползвайте
GetMappedFileInfo, за да потвърдите дали картирането е активно и да прегледате текущата статистика за изгледа и четенията