LoadOptions

LoadOptions class

Consente di specificare opzioni aggiuntive (come password o URI di base) quando si carica un documento in unDocument oggetto.

Per saperne di più, visita ilSpecificare le opzioni di carico articolo di documentazione.

public class LoadOptions

Costruttori

NomeDescrizione
LoadOptions()Inizializza una nuova istanza di questa classe con valori predefiniti.
LoadOptions(string)Una scorciatoia per inizializzare una nuova istanza di questa classe con la password specificata per caricare un documento crittografato.
LoadOptions(LoadFormat, string, string)Una scorciatoia per inizializzare una nuova istanza di questa classe con proprietà impostate sui valori specificati.

Proprietà

NomeDescrizione
BaseUri { get; set; }Ottiene o imposta la stringa che verrà utilizzata per risolvere gli URI relativi trovati nel documento in URI assoluti quando richiesto. Può esserenull o stringa vuota. Il valore predefinito ènull .
ConvertMetafilesToPng { get; set; }Ottiene o imposta se convertire metafile(Wmf OEmf ) immagini aPngformato immagine.
ConvertShapeToOfficeMath { get; set; }Ottiene o imposta se convertire le forme con EquationXML in oggetti Office Math.
Encoding { get; set; }Ottiene o imposta la codifica che verrà utilizzata per caricare un documento HTML, TXT o CHM se la codifica non è specificata all’interno del documento. Può esserenull Il valore predefinito ènull .
FontSettings { get; set; }Consente di specificare le impostazioni del font del documento.
IgnoreOleData { get; set; }Specifica se ignorare i dati OLE.
LanguagePreferences { get; }Ottiene le preferenze di lingua che verranno utilizzate durante il caricamento del documento.
LoadFormat { get; set; }Specifica il formato del documento da caricare. Il valore predefinito èAuto .
MswVersion { get; set; }Consente di specificare che il processo di caricamento del documento deve corrispondere a una versione specifica di MS Word. Il valore predefinito èWord2019
Password { get; set; }Ottiene o imposta la password per l’apertura di un documento crittografato. Può esserenull o stringa vuota. Il valore predefinito ènull .
PreserveIncludePictureField { get; set; }Ottiene o imposta se preservare il campo INCLUDEPICTURE durante la lettura dei formati Microsoft Word. Il valore predefinito èfalso .
ProgressCallback { get; set; }Viene chiamato durante il caricamento di un documento e accetta dati sullo stato di avanzamento del caricamento.
ResourceLoadingCallback { get; set; }Consente di controllare come vengono caricate le risorse esterne (immagini, fogli di stile) quando un documento viene importato da HTML, MHTML.
TempFolder { get; set; }Consente di utilizzare file temporanei durante la lettura del documento. Per impostazione predefinita, questa proprietà ènull e non vengono utilizzati file temporanei.
UpdateDirtyFields { get; set; }Specifica se aggiornare i campi con ilsporco attributo.
UseSystemLcid { get; set; }Ottiene o imposta se utilizzare il valore LCID ottenuto dal registro di Windows per determinare i margini predefiniti di impostazione della pagina.
WarningCallback { get; set; }Chiamato durante un’operazione di caricamento, quando viene rilevato un problema che potrebbe causare la perdita di fedeltà dei dati o della formattazione.

Metodi

NomeDescrizione
override Equals(object)Determina se l’oggetto specificato ha un valore uguale all’oggetto corrente.

Esempi

Mostra come caricare un documento Microsoft Word crittografato.

Document doc;

// Aspose.Words genera un'eccezione se proviamo ad aprire un documento crittografato senza la relativa password.
Assert.Throws<IncorrectPasswordException>(() => doc = new Document(MyDir + "Encrypted.docx"));

// Quando si carica un documento di questo tipo, la password viene passata al costruttore del documento tramite un oggetto LoadOptions.
LoadOptions options = new LoadOptions("docPassword");

// Esistono due modi per caricare un documento crittografato con un oggetto LoadOptions.
// 1 - Carica il documento dal file system locale in base al nome file:
doc = new Document(MyDir + "Encrypted.docx", options);
// 2 - Carica il documento da un flusso:
using (Stream stream = File.OpenRead(MyDir + "Encrypted.docx"))
{
    doc = new Document(stream, options);
}

Guarda anche