LoadOptions

LoadOptions class

Ermöglicht die Angabe zusätzlicher Optionen (wie Passwort oder Basis-URI) beim Laden eines Dokuments in einDocument Objekt.

Um mehr zu erfahren, besuchen Sie dieLadeoptionen festlegen Dokumentationsartikel.

public class LoadOptions

Konstrukteure

NameBeschreibung
LoadOptions()Initialisiert eine neue Instanz dieser Klasse mit Standardwerten.
LoadOptions(string)Eine Verknüpfung zum Initialisieren einer neuen Instanz dieser Klasse mit dem angegebenen Kennwort zum Laden eines verschlüsselten Dokuments.
LoadOptions(LoadFormat, string, string)Eine Verknüpfung zum Initialisieren einer neuen Instanz dieser Klasse mit Eigenschaften, die auf die angegebenen Werte gesetzt sind.

Eigenschaften

NameBeschreibung
BaseUri { get; set; }Ruft die Zeichenfolge ab oder legt sie fest, die verwendet wird, um im Dokument gefundene relative URIs bei Bedarf in absolute URIs aufzulösen. Kann seinnull oder leere Zeichenfolge. Standard istnull .
ConvertMetafilesToPng { get; set; }Ruft ab oder legt fest, ob Metadateien konvertiert werden sollen (Wmf oderEmf ) Bilder zuPngBildformat.
ConvertShapeToOfficeMath { get; set; }Ruft ab oder legt fest, ob Formen mit EquationXML in Office Math-Objekte konvertiert werden sollen.
Encoding { get; set; }Ruft die Kodierung ab oder legt sie fest, die zum Laden eines HTML-, TXT- oder CHM-Dokuments verwendet wird, wenn die Kodierung im Dokument nicht angegeben ist . Kann seinnull Standard istnull .
FontSettings { get; set; }Ermöglicht die Festlegung von Schriftarteinstellungen für Dokumente.
IgnoreOleData { get; set; }Gibt an, ob die OLE-Daten ignoriert werden sollen.
LanguagePreferences { get; }Ruft die Spracheinstellungen ab, die beim Laden des Dokuments verwendet werden.
LoadFormat { get; set; }Gibt das Format des zu ladenden Dokuments an. Standard istAuto .
MswVersion { get; set; }Ermöglicht die Angabe, dass der Dokumentladevorgang einer bestimmten MS Word-Version entsprechen soll. Der Standardwert istWord2019
Password { get; set; }Ruft das Kennwort zum Öffnen eines verschlüsselten Dokuments ab oder legt es fest. Kannnull oder leere Zeichenfolge. Standard istnull .
PreserveIncludePictureField { get; set; }Ruft ab oder legt fest, ob das Feld INCLUDEPICTURE beim Lesen von Microsoft Word-Formaten beibehalten werden soll. Der Standardwert istFALSCH .
ProgressCallback { get; set; }Wird während des Ladens eines Dokuments aufgerufen und akzeptiert Daten zum Ladefortschritt.
ResourceLoadingCallback { get; set; }Ermöglicht die Steuerung, wie externe Ressourcen (Bilder, Stylesheets) geladen werden, wenn ein Dokument aus HTML, MHTML importiert wird.
TempFolder { get; set; }Ermöglicht die Verwendung temporärer Dateien beim Lesen von Dokumenten. Standardmäßig ist diese Eigenschaftnull und es werden keine temporären Dateien verwendet.
UpdateDirtyFields { get; set; }Gibt an, ob die Felder mit demschmutzig Attribut.
UseSystemLcid { get; set; }Ruft ab oder legt fest, ob der aus der Windows-Registrierung abgerufene LCID-Wert zum Bestimmen der Standardränder für die Seiteneinrichtung verwendet werden soll.
WarningCallback { get; set; }Wird während eines Ladevorgangs aufgerufen, wenn ein Problem erkannt wird, das zu einem Verlust der Daten- oder Formatierungsgenauigkeit führen kann.

Methoden

NameBeschreibung
override Equals(object)Bestimmt, ob das angegebene Objekt den gleichen Wert wie das aktuelle Objekt hat.

Beispiele

Zeigt, wie ein verschlüsseltes Microsoft Word-Dokument geladen wird.

Document doc;

// Aspose.Words löst eine Ausnahme aus, wenn wir versuchen, ein verschlüsseltes Dokument ohne dessen Kennwort zu öffnen.
Assert.Throws<IncorrectPasswordException>(() => doc = new Document(MyDir + "Encrypted.docx"));

// Beim Laden eines solchen Dokuments wird das Kennwort mithilfe eines LoadOptions-Objekts an den Konstruktor des Dokuments übergeben.
LoadOptions options = new LoadOptions("docPassword");

// Es gibt zwei Möglichkeiten, ein verschlüsseltes Dokument mit einem LoadOptions-Objekt zu laden.
// 1 - Laden Sie das Dokument aus dem lokalen Dateisystem nach Dateinamen:
doc = new Document(MyDir + "Encrypted.docx", options);
// 2 - Laden Sie das Dokument aus einem Stream:
using (Stream stream = File.OpenRead(MyDir + "Encrypted.docx"))
{
    doc = new Document(stream, options);
}

Siehe auch