Class LoadOptions
Namespace: Aspose.Words.Loading
Assemblea: Aspose.Words.dll (25.3.0)
Permette di specificare ulteriori opzioni (come password o URI di base) quandoCaricare un documento in un oggetto Aspose.Words.Document.
To learn more, visit the Specify Load Options documentation article.
public class LoadOptionseredità
derivati
ChmLoadOptions,HtmlLoadOptions,MarkdownLoadOptions,PdfLoadOptions,RtfLoadOptions,TxtLoadOptions
I membri ereditari
object.GetType(),object.MemberwiseClone(),object.ToString(),object.Equals(object?),object.Equals(object?, object?),object.ReferenceEquals(object?, object?),object.GetHashCode()
Costruttori
LoadOptions()
Inizia una nuova instanza di questa classe con valori predefiniti.
public LoadOptions()LoadOptions(String)
Un taglio per iniziare una nuova instanza di questa classe con la password specificata per caricare un documento crittografato.
public LoadOptions(string password)Parametri
password string
La password per aprire un documento crittografato. può essere ‘zero’ o ramo vuoto.
LoadOptions(LoadFormat, string, string)
Un taglio per inizializzare una nuova instanza di questa classe con proprietà impostate ai valori specificati.
public LoadOptions(LoadFormat loadFormat, string password, string baseUri)Parametri
loadFormat LoadFormat
Il formato del documento da caricare.
password string
La password per aprire un documento crittografato. può essere ‘zero’ o ramo vuoto.
baseUri string
La riga che verrà utilizzata per risolvere gli URI relativi a assoluto. può essere ‘zero’ o riga vuota.
Proprietà
BaseUri
Riceve o impone la riga che verrà utilizzata per risolvere gli URI relativi trovati nel documento in URI assoluti quando richiesto.Può essere ‘zero’ o riga vuota.
public string BaseUri { get; set; }Valore di proprietà
Notizie
Questa proprietà viene utilizzata per risolvere gli URI relativi in assoluto nei seguenti casi:
- Quando si carica un documento HTML da un flusso e il documento contiene immagini con URI relative e non ha un URI di base specificato nell’elemento HTML BASE.
- Quando si salva un documento in PDF e altri formati, per recuperare le immagini collegate utilizzando URI relative in modo che le immagini possono essere salvate nel documento di uscita.
ConvertMetafilesToPng
Ottieni o imponi se convertire metafili (Aspose.FileFormat.Wmf o Aspose.FileFormat.Emf)Immagini per Aspose.FileFormat.Png formato immagine.
public bool ConvertMetafilesToPng { get; set; }Valore di proprietà
Notizie
I metafili (Aspose.FileFormat.Wmf o Aspose.FileFormat.Emf)è un formato immagine non compreso e a volte richiede un sacco di RAM per tenere e elaborare il documento.Questa opzione consente di convertire tutte le immagini metafiliche in Aspose.FileFormat.Png sul caricamento del documento.Si prega di notare che la conversione dei grafici vectori a raster riduce la qualità delle immagini.
ConvertShapeToOfficeMath
Riceve o impone se convertire le forme con EquationXML agli oggetti di Office Math.
public bool ConvertShapeToOfficeMath { get; set; }Valore di proprietà
Encoding
Riceve o impone il codice che verrà utilizzato per caricare un documento HTML, TXT o CHM se il codice non è specificato all’interno del documento.Può essere ‘zero’.
public Encoding Encoding { get; set; }Valore di proprietà
Notizie
Questa proprietà viene utilizzata solo quando si caricano documenti HTML, TXT o CHM.
Se la codifica non è specificata all’interno del documento e questa proprietà è , allora il sistema cercherà di rilevare automaticamente la codifica.
FontSettings
Permette di specificare le impostazioni di font del documento.
public FontSettings FontSettings { get; set; }Valore di proprietà
Notizie
Quando si caricano alcuni formati, Aspose.Words può richiedere di risolvere le font. Ad esempio, quando si caricano documenti HTML Aspose.Words può risolvere le font per eseguire il fallback delle font.
Se impostato a , le impostazioni di font statico predefinito Aspose.Words.Fonts.FontSettings.DefaultInstance sarà utilizzato.
Il valore default è.
IgnoreOleData
Determinare se ignorare i dati OLE.
public bool IgnoreOleData { get; set; }Valore di proprietà
Notizie
Ignorare i dati OLE può ridurre il consumo di memoria e aumentare le prestazioni senza dati persi in un caso in cui il formato di destinazione non supporta gli oggetti OLE.
Il valore default è.
LanguagePreferences
Riceve preferenze linguistiche che saranno utilizzate quando il documento è caricato.
public LanguagePreferences LanguagePreferences { get; }Valore di proprietà
LoadFormat
Indica il formato del documento da caricare.Il modello è Aspose.Words.LoadFormat.Auto.
public LoadFormat LoadFormat { get; set; }Valore di proprietà
Notizie
Si consiglia di specificare il valore Aspose.Words.LoadFormat.Auto e lasciare Aspose.Words rilevare il formato del file automaticamente. Se si sa il formato del documento che si sta per caricare, si può specificare il formato esplicitamente e questo ridurrà leggermente il tempo di caricamento da parte della parte superiore associato con la rilevazione automatica del formato. Se si specifica un formato esplicito di caricamento e si scoprirà di essere sbagliato, la rilevazione automatica sarà invocato e un secondo tentativo di caricamento del file sarà fatto.
MswVersion
Permette di specificare che il processo di caricamento del documento dovrebbe corrispondere a una versione specifica di MS Word.Il valore predefinito è Aspose.Words.Settings.MsWordVersion.Word2019
public MsWordVersion MswVersion { get; set; }Valore di proprietà
Notizie
Diverse versioni di Word possono gestire alcuni aspetti del contenuto del documento e formattare leggermente diversamentedurante il processo di caricamento, che può portare a piccole differenze nel modello di oggetto del documento.
Password
Riceve o impone la password per aprire un documento crittografato.Può essere ‘zero’ o righe vuote.
public string Password { get; set; }Valore di proprietà
Notizie
È necessario conoscere la password per aprire un documento crittografato.Se il documento non è crittografato, impostare questo su o vuota stringhe.
PreserveIncludePictureField
Riceve o impone se conservare il campo INCLUDEPICTURE durante la lettura dei formati di Microsoft Word.Il valore predefinito è ‘falso’.
public bool PreserveIncludePictureField { get; set; }Valore di proprietà
Notizie
Per impostazione predefinita, il campo INCLUDEPICTURE è convertito in un oggetto di forma. Puoi superare che se hai bisogno del campo per essere conservato, ad esempio, se vuoi aggiornarlo programmaticamente. Nota tuttavia che questo approccio non è comune per Aspose.Words. Utilizzarlo a proprio rischio.
Uno dei possibili casi di utilizzo può essere l’utilizzo di un MERGEFIELD come campo per cambiare dinamicamente la strada sorgente dell’immagine.
ProgressCallback
Chiamato durante il caricamento di un documento e accetta i dati sul progresso del caricamento.
public IDocumentLoadingCallback ProgressCallback { get; set; }Valore di proprietà
Notizie
Aspose.Words.LoadFormat.Docx, Aspose.Words.LoadFormat.FlatOpc, Aspose.Words.LoadFormat.Docm, Aspose.Words.LoadFormat.Dotm, Aspose.Words.LoadFormat.Dotx, Aspose.Words.LoadFormat.Markdown, Aspose.Words.LoadFormat.Rtf, Aspose.Words.LoadFormat.WordML, Aspose.Words.LoadFormat.Doc, Aspose.Words.LoadFormat.Dot, Aspose.Words.LoadFormat.Odt, Aspose.Words.LoadFormat.Ott formats supported.
ResourceLoadingCallback
Permette di controllare come le risorse esterne (immagini, fogli di stile) vengono caricate quando un documento viene importato da HTML, MHTML.
public IResourceLoadingCallback ResourceLoadingCallback { get; set; }Valore di proprietà
TempFolder
Permette l’uso di file temporanei durante la lettura del documento.Per impostazione predefinita questa proprietà è ‘zero’ e non vengono utilizzati file temporanei.
public string TempFolder { get; set; }Valore di proprietà
Notizie
La cartella deve esistere e essere scritta, altrimenti verrà gettata un’eccezione.
Aspose.Words rimuove automaticamente tutti i file temporanei quando la lettura è completa.
UpdateDirtyFields
Determinare se aggiornare i campi con l’attributo " sporco".
public bool UpdateDirtyFields { get; set; }Valore di proprietà
UseSystemLcid
Riceve o impone se utilizzare il valore LCID ottenuto dal registro Windows per determinare i margini di impostazione della pagina.
public bool UseSystemLcid { get; set; }Valore di proprietà
Notizie
If set to , then MS Word behavior is emulated which takes LCID value from Windows registry.
Il valore default è.
WarningCallback
Chiamato durante un’operazione di carico, quando viene rilevato un problema che potrebbe portare alla perdita di fedeltà dei dati o del formato.
public IWarningCallback WarningCallback { get; set; }Valore di proprietà
Metodi
Equals(oggetto)
Determinare se l’oggetto specificato è uguale in valore all’oggetto corrente.
public override bool Equals(object obj)Parametri
obj object
