LoadOptions

LoadOptions class

Permite especificar opciones adicionales (como contraseña o URI base) al cargar un documento en unDocument objeto.

Para obtener más información, visite elEspecificar opciones de carga Artículo de documentación.

public class LoadOptions

Constructores

NombreDescripción
LoadOptions()Inicializa una nueva instancia de esta clase con valores predeterminados.
LoadOptions(string)Un acceso directo para inicializar una nueva instancia de esta clase con la contraseña especificada para cargar un documento cifrado.
LoadOptions(LoadFormat, string, string)Un acceso directo para inicializar una nueva instancia de esta clase con propiedades establecidas en los valores especificados.

Propiedades

NombreDescripción
BaseUri { get; set; }Obtiene o establece la cadena que se utilizará para resolver los URI relativos encontrados en el documento en URI absolutos cuando sea necesario. Puede sernulo o cadena vacía. El valor predeterminado esnulo .
ConvertMetafilesToPng { get; set; }Obtiene o establece si se debe convertir el metarchivo(Wmf oEmf ) imágenes aPngformato de imagen.
ConvertShapeToOfficeMath { get; set; }Obtiene o establece si se deben convertir formas con EquationXML en objetos de Office Math.
Encoding { get; set; }Obtiene o establece la codificación que se utilizará para cargar un documento HTML, TXT o CHM si no se especifica la codificación dentro del documento. Puede sernulo El valor predeterminado esnulo .
FontSettings { get; set; }Permite especificar la configuración de fuentes del documento.
IgnoreOleData { get; set; }Especifica si se deben ignorar los datos OLE.
LanguagePreferences { get; }Obtiene las preferencias de idioma que se utilizarán cuando se cargue el documento.
LoadFormat { get; set; }Especifica el formato del documento que se va a cargar. El valor predeterminado esAuto .
MswVersion { get; set; }Permite especificar que el proceso de carga del documento debe coincidir con una versión específica de MS Word. El valor predeterminado esWord2019
Password { get; set; }Obtiene o establece la contraseña para abrir un documento cifrado. Puede sernulo o cadena vacía. El valor predeterminado esnulo .
PreserveIncludePictureField { get; set; }Obtiene o establece si se debe conservar el campo INCLUDEPICTURE al leer formatos de Microsoft Word. El valor predeterminado esFALSO .
ProgressCallback { get; set; }Se llama durante la carga de un documento y acepta datos sobre el progreso de la carga.
ResourceLoadingCallback { get; set; }Permite controlar cómo se cargan los recursos externos (imágenes, hojas de estilo) cuando se importa un documento desde HTML, MHTML.
TempFolder { get; set; }Permite utilizar archivos temporales al leer el documento. Por defecto esta propiedad esnulo y no se utilizan archivos temporales.
UpdateDirtyFields { get; set; }Especifica si se deben actualizar los campos con elsucio atributo.
UseSystemLcid { get; set; }Obtiene o establece si se debe utilizar el valor LCID obtenido del registro de Windows para determinar los márgenes predeterminados de configuración de página.
WarningCallback { get; set; }Se llama durante una operación de carga, cuando se detecta un problema que podría provocar pérdida de fidelidad de datos o formato.

Métodos

NombreDescripción
override Equals(object)Determina si el objeto especificado es igual en valor al objeto actual.

Ejemplos

Muestra cómo cargar un documento de Microsoft Word cifrado.

Document doc;

// Aspose.Words lanza una excepción si intentamos abrir un documento cifrado sin su contraseña.
Assert.Throws<IncorrectPasswordException>(() => doc = new Document(MyDir + "Encrypted.docx"));

// Al cargar dicho documento, la contraseña se pasa al constructor del documento mediante un objeto LoadOptions.
LoadOptions options = new LoadOptions("docPassword");

// Hay dos formas de cargar un documento cifrado con un objeto LoadOptions.
// 1 - Cargar el documento desde el sistema de archivos local por nombre de archivo:
doc = new Document(MyDir + "Encrypted.docx", options);
// 2 - Cargar el documento desde un stream:
using (Stream stream = File.OpenRead(MyDir + "Encrypted.docx"))
{
    doc = new Document(stream, options);
}

Ver también