Class Document

Class Document

Namespace: Aspose.Pdf
Assembly: Aspose.PDF.dll

Clase que representa un documento PDF

public sealed class Document : IDisposable

Herencia

objectDocument

Implementa

IDisposable

Miembros heredados

object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Constructores

Document(Stream)

Inicializa una nueva instancia de Document a partir del flujo input.

public Document(Stream input)

Parámetros

input Stream

Flujo con el documento pdf.

Document(Stream, string, bool)

Inicializa una nueva instancia de Document a partir del flujo input.

public Document(Stream input, string password, bool isManagedStream)

Parámetros

input Stream

Flujo con el documento pdf.

password string

Contraseña de usuario o propietario.

isManagedStream bool

si se establece en true el flujo interno se cierra antes de salir; de lo contrario, no.

Document(Stream, bool)

Inicializa una nueva instancia de Document a partir del flujo input.

public Document(Stream input, bool isManagedStream)

Parámetros

input Stream

Flujo con el documento pdf.

isManagedStream bool

si se establece en true el flujo interno se cierra antes de salir; de lo contrario, no.

Document(string)

Solo inicializa Document usando filename. Igual que Aspose.Pdf.Document.#ctor(System.IO.Stream).

public Document(string filename)

Parámetros

filename string

El nombre del archivo del documento pdf.

Document(Stream, string)

Inicializa una nueva instancia de Document a partir del flujo input.

public Document(Stream input, string password)

Parámetros

input Stream

Objeto de flujo de entrada, el pdf está protegido por contraseña.

password string

Contraseña de usuario o propietario.

Document()

Inicializa un documento vacío.

public Document()

Document(string, string)

Inicializa una nueva instancia de la clase Aspose.Pdf.Document para trabajar con documentos encriptados.

public Document(string filename, string password)

Parámetros

filename string

Nombre del archivo del documento.

password string

Contraseña de usuario o propietario.

Document(string, string, bool)

Inicializa una nueva instancia de la clase Aspose.Pdf.Document para trabajar con documentos encriptados.

public Document(string filename, string password, bool isManagedStream)

Parámetros

filename string

Nombre del archivo del documento.

password string

Contraseña de usuario o propietario.

isManagedStream bool

si se establece en true el flujo interno se cierra antes de salir; de lo contrario, no.

Document(string, LoadOptions)

Abre un documento existente desde un archivo proporcionando las opciones necesarias de conversión para obtener un documento pdf.

public Document(string filename, LoadOptions options)

Parámetros

filename string

Archivo de entrada para convertir en documento pdf.

options LoadOptions

Representa propiedades para convertir filename en documento pdf.

Document(Stream, LoadOptions)

Abre un documento existente desde un flujo proporcionando la conversión necesaria para obtener un documento pdf.

public Document(Stream input, LoadOptions options)

Parámetros

input Stream

Flujo de entrada para convertir en documento pdf.

options LoadOptions

Representa propiedades para convertir input en documento pdf.

Campos

DefaultNodesNumInSubtrees

public const byte DefaultNodesNumInSubtrees = 10

Valor del campo

byte

Propiedades

Actions

Obtiene las acciones del documento. Esta propiedad es una instancia de la clase DocumentActions que permite obtener/establecer acciones BeforClosing, BeforSaving, etc.

public DocumentActionCollection Actions { get; }

Valor de la propiedad

DocumentActionCollection

Ejemplos

Este ejemplo demuestra cómo obtener la acción después de abrir el documento:

Aspose.Pdf.Document document = new Aspose.Pdf.Document("d:\\work\\aspose\\aspose.pdf.kit.net.new\\trunk\\testdata\\Aspose.Pdf\\PdfWithOpenAction.pdf");
Aspose.Pdf.Annotations.DocumentActionCollection actions = document.Actions;
Aspose.Pdf.Annotations.PdfAction afterSavingAction = actions.AfterSaving;

AllowReusePageContent

Permite fusionar contenidos de página para optimizar el tamaño del documento. Si se usa, entonces diferentes páginas pero duplicadas pueden hacer referencia al mismo objeto de contenido. Tenga en cuenta que este modo puede causar efectos secundarios como cambiar el contenido de la página cuando se cambia otra página.

public bool AllowReusePageContent { get; set; }

Valor de la propiedad

bool

Background

Obtiene o establece el color de fondo del documento.

public Color Background { get; set; }

Valor de la propiedad

Color

CenterWindow

Obtiene o establece un indicador que especifica si la posición de la ventana del documento se centrará en la pantalla.

public bool CenterWindow { get; set; }

Valor de la propiedad

bool

Ejemplos

El ejemplo demuestra cómo obtener el indicador CenterWindow:

Document document = new Document("sample.pdf");
bool value = document.CenterWindow;

Collection

Obtiene la colección del documento.

public Collection Collection { get; set; }

Valor de la propiedad

Collection

CryptoAlgorithm

Obtiene la configuración de seguridad si el documento está encriptado. Si el documento no está encriptado, se generará la excepción correspondiente en .net 1.1 o CryptoAlgorithm será nulo para otras versiones de .net.

public CryptoAlgorithm? CryptoAlgorithm { get; }

Valor de la propiedad

CryptoAlgorithm?

Destinations

Obtiene la colección de destinos. Obsoleto. Por favor, use NamedDestinations.

public DestinationCollection Destinations { get; }

Valor de la propiedad

DestinationCollection

Direction

Obtiene o establece el orden de lectura del texto: L2R (de izquierda a derecha) o R2L (de derecha a izquierda).

public Direction Direction { get; set; }

Valor de la propiedad

Direction

DisableFontLicenseVerifications

Muchas operaciones con fuentes no se pueden ejecutar si estas operaciones están prohibidas por la licencia de esta fuente. Por ejemplo, algunas fuentes no se pueden incrustar en el documento PDF si las reglas de la licencia deshabilitan la incrustación para esta fuente. Este indicador se utiliza para deshabilitar cualquier restricción de licencia para todas las fuentes en el documento PDF actual. Tenga cuidado al usar este indicador. Cuando se establece, significa que la persona que establece este indicador asume toda la responsabilidad de posibles violaciones de licencia/ley. Así que lo asume bajo su propio riesgo. Se recomienda encarecidamente usar este indicador solo cuando esté completamente seguro de que no está infringiendo la ley de derechos de autor. Por defecto, falso.

public bool DisableFontLicenseVerifications { get; set; }

Valor de la propiedad

bool

DisplayDocTitle

Obtiene o establece un indicador que especifica si la barra de título de la ventana del documento debe mostrar el título del documento.

public bool DisplayDocTitle { get; set; }

Valor de la propiedad

bool

Ejemplos

El ejemplo demuestra cómo obtener el indicador DisplayDocTitle:

Document document = new Document("sample.pdf");
bool value = document.DisplayDocTitle;

Duplex

Obtiene o establece la opción de manejo del modo de impresión dúplex que se utilizará al imprimir el archivo desde el cuadro de diálogo de impresión.

public PrintDuplex Duplex { get; set; }

Valor de la propiedad

PrintDuplex

EmbedStandardFonts

Propiedad que declara que el documento debe incrustar todas las fuentes estándar Type1 que tienen el indicador IsEmbedded establecido en verdadero. Todas las fuentes PDF se pueden incrustar en el documento simplemente configurando el indicador IsEmbedded en verdadero, pero las fuentes estándar Type1 de PDF son una excepción a esta regla. La incrustación de fuentes estándar Type1 requiere mucho tiempo, por lo que para incrustar estas fuentes es necesario no solo establecer el indicador IsEmbedded en verdadero para la fuente especificada, sino también establecer un indicador adicional a nivel de documento - EmbedStandardFonts = true; Esta propiedad solo se puede establecer una vez para todas las fuentes. Por defecto, falso.

public bool EmbedStandardFonts { get; set; }

Valor de la propiedad

bool

EmbeddedFiles

Obtiene la colección de archivos incrustados en el documento.

public EmbeddedFileCollection EmbeddedFiles { get; }

Valor de la propiedad

EmbeddedFileCollection

EnableObjectUnload

Obtiene o establece un indicador que permite que el documento se descargue parcialmente de la memoria. Esto permite reducir el uso de memoria, pero puede tener un efecto negativo en el rendimiento.

public bool EnableObjectUnload { get; set; }

Valor de la propiedad

bool

EnableSignatureSanitization

Obtiene o establece un indicador para gestionar la sanitización de campos de firma. Habilitado por defecto.

public bool EnableSignatureSanitization { get; set; }

Valor de la propiedad

bool

FileName

Nombre del archivo PDF que causó este documento

public string FileName { get; }

Valor de la propiedad

string

FitWindow

Obtiene o establece un indicador que especifica si la ventana del documento debe ser redimensionada para ajustarse a la primera página mostrada.

public bool FitWindow { get; set; }

Valor de la propiedad

bool

Ejemplos

El ejemplo demuestra cómo obtener el indicador FitWindow:

Document document = new Document("sample.pdf");
bool value = document.FitWindow;

FontUtilities

Instancia de IDocumentFontUtilities

public Document.IDocumentFontUtilities FontUtilities { get; }

Valor de la propiedad

Document.IDocumentFontUtilities

Form

Obtiene el formulario Acro del documento.

public Form Form { get; }

Valor de la propiedad

Form

HandleSignatureChange

Lanza una excepción si el documento se guarda con cambios y tiene firma

public bool HandleSignatureChange { get; set; }

Valor de la propiedad

bool

HideMenubar

Obtiene o establece un indicador que especifica si la barra de menú debe estar oculta cuando el documento está activo.

public bool HideMenubar { get; set; }

Valor de la propiedad

bool

Ejemplos

El ejemplo demuestra cómo obtener el indicador HideMenubar:

Document document = new Document("sample.pdf");
bool value = document.HideMenubar;

HideToolBar

Obtiene o establece un indicador que especifica si la barra de herramientas debe estar oculta cuando el documento está activo.

public bool HideToolBar { get; set; }

Valor de la propiedad

bool

Ejemplos

El ejemplo demuestra cómo obtener el indicador HideToolBar:

Document document = new Document("sample.pdf");
bool value = document.HideToolBar;

HideWindowUI

Obtiene o establece un indicador que especifica si los elementos de la interfaz de usuario deben estar ocultos cuando el documento está activo.

public bool HideWindowUI { get; set; }

Valor de la propiedad

bool

Ejemplos

El ejemplo demuestra cómo obtener el indicador HideWindowUI:

Document document = new Document("sample.pdf");
bool value = document.HideWindowUI;

Id

Obtiene el ID.

public Id Id { get; }

Valor de la propiedad

Id

IgnoreCorruptedObjects

Obtiene o establece un indicador para ignorar errores en archivos fuente. Cuando se copian páginas del documento fuente al documento de destino, el proceso de copia se detiene con una excepción si algunos objetos en los archivos fuente están corruptos cuando este indicador es falso. ejemplo: dest.Pages.Add(src.Pages); Si este indicador se establece en verdadero, los objetos corruptos se reemplazarán con valores vacíos. Por defecto: verdadero.

public bool IgnoreCorruptedObjects { get; set; }

Valor de la propiedad

bool

Info

Obtiene la información del documento.

public DocumentInfo Info { get; }

Valor de la propiedad

DocumentInfo

IsEncrypted

Obtiene el estado de encriptación del documento. Verdadero si el documento está encriptado.

public bool IsEncrypted { get; }

Valor de la propiedad

bool

IsLicensed

Obtiene el estado de licencia del sistema. Devuelve verdadero si el sistema funciona en modo con licencia y falso en caso contrario.

public static bool IsLicensed { get; }

Valor de la propiedad

bool

IsLinearized

Obtiene o establece un valor que indica si el documento está linealizado.

public bool IsLinearized { get; set; }

Valor de la propiedad

bool

IsPdfUaCompliant

Obtiene si el documento cumple con pdfua.

public bool IsPdfUaCompliant { get; }

Valor de la propiedad

bool

IsPdfaCompliant

Obtiene si el documento cumple con pdfa.

public bool IsPdfaCompliant { get; }

Valor de la propiedad

bool

IsXrefGapsAllowed

Obtiene o establece si el documento permite huecos en el xref.

public bool IsXrefGapsAllowed { get; set; }

Valor de la propiedad

bool

JavaScript

Colección de JavaScript a nivel de documento.

public JavaScriptCollection JavaScript { get; }

Valor de la propiedad

JavaScriptCollection

LogicalStructure

Obtiene la estructura lógica del documento.

public RootElement LogicalStructure { get; }

Valor de la propiedad

RootElement

Metadata

Metadatos del documento. (Un documento PDF puede incluir información general, como el título del documento, autor y fechas de creación y modificación. Dicha información global sobre el documento (en contraposición a su contenido o estructura) se llama metadatos y está destinada a ayudar en la catalogación y búsqueda de documentos en bases de datos externas.)

public Metadata Metadata { get; }

Valor de la propiedad

Metadata

NamedDestinations

Colección de Destinos Nombrados en el documento.

public NamedDestinationCollection NamedDestinations { get; }

Valor de la propiedad

NamedDestinationCollection

NonFullScreenPageMode

Obtiene o establece el modo de página, especificando cómo mostrar el documento al salir del modo de pantalla completa.

public PageMode NonFullScreenPageMode { get; set; }

Valor de la propiedad

PageMode

OpenAction

Obtiene o establece la acción realizada al abrir el documento.

public IAppointment OpenAction { get; set; }

Valor de la propiedad

IAppointment

Ejemplos

El ejemplo demuestra cómo obtener el indicador CenterWindow:

Document document = new Document("sample.pdf");
IAppointment value = document.OpenAction;

OptimizeSize

Obtiene o establece el indicador de optimización. Cuando se añaden páginas al documento, los flujos de recursos iguales en el archivo resultante se fusionan en un solo objeto PDF si este indicador está establecido. Esto permite reducir el tamaño del archivo resultante, pero puede causar una ejecución más lenta y mayores requisitos de memoria. Valor predeterminado: falso.

public bool OptimizeSize { get; set; }

Valor de la propiedad

bool

Outlines

Obtiene los contornos del documento.

public OutlineCollection Outlines { get; }

Valor de la propiedad

OutlineCollection

OutputIntents

Obtiene la colección de Intenciones de Salida en el documento.

public OutputIntents OutputIntents { get; }

Valor de la propiedad

OutputIntents

PageInfo

Obtiene o establece la información de la página.(solo para generador, no se llena al leer el documento)

public PageInfo PageInfo { get; set; }

Valor de la propiedad

PageInfo

PageLabels

Obtiene las etiquetas de página en el documento.

public PageLabelCollection PageLabels { get; }

Valor de la propiedad

PageLabelCollection

PageLayout

Obtiene o establece el diseño de página que se utilizará cuando se abra el documento.

public PageLayout PageLayout { get; set; }

Valor de la propiedad

PageLayout

PageMode

Obtiene o establece el modo de página, especificando cómo debe mostrarse el documento al abrirse.

public PageMode PageMode { get; set; }

Valor de la propiedad

PageMode

Pages

Obtiene o establece la colección de páginas del documento. Tenga en cuenta que las páginas están numeradas desde 1 en la colección.

public PageCollection Pages { get; }

Valor de la propiedad

PageCollection

Ejemplos

El ejemplo a continuación demuestra cómo operar con las páginas del documento: Cómo obtener el número de páginas y cómo obtener el rectángulo de la página inicial del documento.

Aspose.Pdf.Document document = new Aspose.Pdf.Document("sample.pdf");
Aspose.Pdf.PageCollection pages = document.Pages;
System.Console.WriteLine("El documento contiene " + pages.Count);
Page page = pages[1];
Rectangle rect = page.Rect;

PdfFormat

Obtiene el formato PDF

public PdfFormat PdfFormat { get; }

Valor de la propiedad

PdfFormat

Permissions

Obtiene los permisos del documento.

public int Permissions { get; }

Valor de la propiedad

int

PickTrayByPdfSize

Obtiene o establece un indicador que especifica si el tamaño de página PDF debe usarse para seleccionar la bandeja de papel de entrada.

public bool PickTrayByPdfSize { get; set; }

Valor de la propiedad

bool

PrintScaling

Obtiene o establece la opción de escalado de página que se seleccionará cuando se muestre un cuadro de diálogo de impresión para este documento.

public PrintScaling PrintScaling { get; set; }

Valor de la propiedad

PrintScaling

TaggedContent

Obtiene acceso al contenido TaggedPdf.

public ITaggedContent TaggedContent { get; }

Valor de la propiedad

ITaggedContent

Ejemplos

El ejemplo demuestra cómo usar contenido etiquetado para crear un nuevo documento con encabezado, párrafos e imágenes.

// Crear nuevo documento
Document document = new Document();

// Obtener el contenido etiquetado
ITaggedContent taggedContent = document.TaggedContent;

// Establecer el idioma para el documento
taggedContent.SetLanguage("en-US");

// Establecer el título para el documento PDF
taggedContent.SetTitle("Documento de ejemplo");

// Crear y añadir Sección
SectElement sect = taggedContent.CreateSectElement();
taggedContent.RootElement.AppendChild(sect);

// Crear Encabezado
HeaderElement h1 = taggedContent.CreateHeaderElement(1);
h1.SetText("El Encabezado");
sect.AppendChild(h1);

// Crear párrafo
ParagraphElement p = taggedContent.CreateParagraphElement();
p.SetTag("Paragraph");
p.SetText("El texto del párrafo.");
sect.AppendChild(p);

// Crear ilustración
IllustrationElement figure1 = taggedContent.CreateFigureElement();
sect.AppendChild(figure1);
figure1.AlternativeText = "Figura 1";
figure1.Title = "Imagen 1";
figure1.SetTag("Fig");
figure1.SetImage("ruta/de/la/imagen.jpg");

// Guardar documento
document.Save("example.pdf");

Version

Obtiene una versión de Pdf desde el encabezado del archivo Pdf.

public string Version { get; }

Valor de la propiedad

string

Métodos

BindXml(string)

Vincula xml al documento

public void BindXml(string file)

Parámetros

file string

El archivo xml

BindXml(string, string)

Vincula xml/xsl al documento

public void BindXml(string xmlFile, string xslFile)

Parámetros

xmlFile string

El archivo xml.

xslFile string

El archivo xsl si se usa XSLT.

BindXml(Stream, Stream)

Vincula xml/xsl al documento

public void BindXml(Stream xmlStream, Stream xslStream)

Parámetros

xmlStream Stream

El flujo xml.

xslStream Stream

El flujo xsl si se usa XSLT.

BindXml(Stream, Stream, XmlReaderSettings)

Vincula xml/xsl al documento

public void BindXml(Stream xmlStream, Stream xslStream, XmlReaderSettings settings)

Parámetros

xmlStream Stream

El flujo xml.

xslStream Stream

El flujo xsl si se usa XSLT.

settings XmlReaderSettings

La configuración del lector xml.

BindXml(Stream)

Vincula xml al documento

public void BindXml(Stream stream)

Parámetros

stream Stream

El flujo xml.

ChangePasswords(string, string, string)

Cambia las contraseñas del documento. Esta acción solo se puede realizar utilizando la contraseña del propietario.

public void ChangePasswords(string ownerPassword, string newUserPassword, string newOwnerPassword)

Parámetros

ownerPassword string

Contraseña del propietario.

newUserPassword string

Nueva contraseña de usuario.

newOwnerPassword string

Nueva contraseña de propietario.

Check(bool)

Valida el documento.

public bool Check(bool doRepair)

Parámetros

doRepair bool

Si es verdadero, los problemas encontrados serán reparados.

Devuelve

bool

Verdadero - si el documento fue reparado; de lo contrario, falso.

Convert(string, PdfFormat, ConvertErrorAction, ConvertTransparencyAction)

Convierte el documento y guarda los errores en el archivo especificado.

public bool Convert(string outputLogFileName, PdfFormat format, ConvertErrorAction action, ConvertTransparencyAction transparencyAction)

Parámetros

outputLogFileName string

Ruta al archivo donde se almacenarán los comentarios.

format PdfFormat

El formato pdf.

action ConvertErrorAction

Acción para objetos que no se pueden convertir

transparencyAction ConvertTransparencyAction

Acción para objetos de imagen enmascarados

Devuelve

bool

El resultado de la operación

Convert(Stream, PdfFormat, ConvertErrorAction, ConvertTransparencyAction)

Convierte el documento y guarda los errores en el archivo especificado.

public bool Convert(Stream outputLogStream, PdfFormat format, ConvertErrorAction action, ConvertTransparencyAction transparencyAction)

Parámetros

outputLogStream Stream

Flujo donde se almacenarán los comentarios.

format PdfFormat

El formato pdf.

action ConvertErrorAction

Acción para objetos que no se pueden convertir

transparencyAction ConvertTransparencyAction

Acción para objetos de imagen enmascarados

Devuelve

bool

El resultado de la operación

Convert(string, PdfFormat, ConvertErrorAction)

Convierte el documento y guarda los errores en el archivo especificado.

public bool Convert(string outputLogFileName, PdfFormat format, ConvertErrorAction action)

Parámetros

outputLogFileName string

Ruta al archivo donde se almacenarán los comentarios.

format PdfFormat

El formato pdf.

action ConvertErrorAction

Acción para objetos que no se pueden convertir

Devuelve

bool

El resultado de la operación

Convert(PdfFormatConversionOptions)

Convierte el documento utilizando las opciones de conversión especificadas.

public bool Convert(PdfFormatConversionOptions options)

Parámetros

options PdfFormatConversionOptions

conjunto de opciones para convertir el documento PDF

Devuelve

bool

El resultado de la operación

Convert(CallBackGetHocrWithPage, bool)

Reconoce imágenes dentro del documento y añade cadenas hocr sobre ellas.

public bool Convert(Document.CallBackGetHocrWithPage callback, bool flattenImages = false)

Parámetros

callback Document.CallBackGetHocrWithPage

Acción para imágenes que serán procesadas por el reconocimiento hocr.

flattenImages bool

El texto en las imágenes pdf puede pintarse utilizando la mecánica de máscaras, en cuyo caso las imágenes deben ser aplanadas.

Devuelve

bool

El resultado de la operación. Si no hay imágenes en el documento, devuelve falso.

Convert(CallBackGetHocr, bool)

Reconoce imágenes dentro del documento y añade cadenas hocr sobre ellas.

public bool Convert(Document.CallBackGetHocr callback, bool flattenImages = false)

Parámetros

callback Document.CallBackGetHocr

Acción para imágenes que serán procesadas por el reconocimiento hocr.

flattenImages bool

El texto en las imágenes pdf puede pintarse utilizando la mecánica de máscaras, en cuyo caso las imágenes deben ser aplanadas.

Devuelve

bool

El resultado de la operación. Si no hay imágenes en el documento, devuelve falso.

Convert(Stream, PdfFormat, ConvertErrorAction)

Convierte el documento y guarda los errores en el flujo especificado.

public bool Convert(Stream outputLogStream, PdfFormat format, ConvertErrorAction action)

Parámetros

outputLogStream Stream

Flujo donde se almacenarán los comentarios.

format PdfFormat

Formato pdf.

action ConvertErrorAction

Acción para objetos que no se pueden convertir

Devuelve

bool

El resultado de la operación

Convert(Fixup, Stream, bool, object[])

Convierte el documento aplicando el Fixup.

public bool Convert(Fixup fixup, Stream outputLog, bool onlyValidation = false, object[] parameters = null)

Parámetros

fixup Fixup

El tipo de Fixup.

outputLog Stream

El registro del proceso.

onlyValidation bool

Solo validación del documento.

parameters object[]

Propiedades para Fixup que no se pueden establecer.

Devuelve

bool

El resultado de la operación.

Convert(Fixup, string, bool, object[])

Convierte el documento aplicando el Fixup.

public bool Convert(Fixup fixup, string outputLog, bool onlyValidation = false, object[] parameters = null)

Parámetros

fixup Fixup

El tipo de Fixup.

outputLog string

El registro del proceso.

onlyValidation bool

Solo validación del documento.

parameters object[]

Propiedades para Fixup que no se pueden establecer.

Devuelve

bool

El resultado de la operación.

Convert(string, LoadOptions, string, SaveOptions)

Convierte el archivo fuente en formato fuente en un archivo de destino en formato de destino.

public static void Convert(string srcFileName, LoadOptions loadOptions, string dstFileName, SaveOptions saveOptions)

Parámetros

srcFileName string

El nombre del archivo fuente.

loadOptions LoadOptions

El formato del archivo fuente.

dstFileName string

El nombre del archivo de destino.

saveOptions SaveOptions

El formato del archivo de destino.

Convert(Stream, LoadOptions, string, SaveOptions)

Convierte el flujo en formato fuente en un archivo de destino en formato de destino.

public static void Convert(Stream srcStream, LoadOptions loadOptions, string dstFileName, SaveOptions saveOptions)

Parámetros

srcStream Stream

El flujo fuente.

loadOptions LoadOptions

El formato del flujo fuente.

dstFileName string

El nombre del archivo de destino.

saveOptions SaveOptions

El formato del archivo de destino.

Convert(string, LoadOptions, Stream, SaveOptions)

Convierte el archivo fuente en formato fuente en un flujo en formato de destino.

public static void Convert(string srcFileName, LoadOptions loadOptions, Stream dstStream, SaveOptions saveOptions)

Parámetros

srcFileName string

El nombre del archivo fuente.

loadOptions LoadOptions

El formato del archivo fuente.

dstStream Stream

El flujo de destino.

saveOptions SaveOptions

El formato del flujo de destino.

Convert(Stream, LoadOptions, Stream, SaveOptions)

Convierte el flujo en formato fuente en un flujo en formato de destino.

public static void Convert(Stream srcStream, LoadOptions loadOptions, Stream dstStream, SaveOptions saveOptions)

Parámetros

srcStream Stream

El flujo fuente.

loadOptions LoadOptions

El formato del flujo fuente.

dstStream Stream

El flujo de destino.

saveOptions SaveOptions

El formato del archivo de destino.

ConvertPageToPNGMemoryStream(Page)

Convierte la página a PNG para DSR, OMR, flujo de imagen OCR.

public MemoryStream ConvertPageToPNGMemoryStream(Page page)

Parámetros

page Page

Página a convertir.

Devuelve

MemoryStream

Flujo de imagen.

Decrypt()

Desencripta el documento. Luego llame a Save para obtener la versión desencriptada del documento.

public void Decrypt()

Dispose()

Cierra todos los recursos utilizados por este documento.

public void Dispose()

Encrypt(string, string, DocumentPrivilege, CryptoAlgorithm, bool)

Encripta el documento. Luego llame a Save para obtener la versión encriptada del documento.

public void Encrypt(string userPassword, string ownerPassword, DocumentPrivilege privileges, CryptoAlgorithm cryptoAlgorithm, bool usePdf20)

Parámetros

userPassword string

Contraseña de usuario.

ownerPassword string

Contraseña de propietario.

privileges DocumentPrivilege

Permisos del documento, consulte Aspose.Pdf.Document.Permissions para más detalles.

cryptoAlgorithm CryptoAlgorithm

Algoritmo criptográfico, consulte Aspose.Pdf.Document.CryptoAlgorithm para más detalles.

usePdf20 bool

Soporte para la revisión 6 (Extensión 8).

Encrypt(string, string, Permissions, CryptoAlgorithm)

Encripta el documento. Luego llame a Save para obtener la versión encriptada del documento.

public void Encrypt(string userPassword, string ownerPassword, Permissions permissions, CryptoAlgorithm cryptoAlgorithm)

Parámetros

userPassword string

Contraseña de usuario.

ownerPassword string

Contraseña de propietario.

permissions Permissions

Permisos del documento, consulte Aspose.Pdf.Document.Permissions para más detalles.

cryptoAlgorithm CryptoAlgorithm

Algoritmo criptográfico, consulte Aspose.Pdf.Document.CryptoAlgorithm para más detalles.

Encrypt(string, string, Permissions, CryptoAlgorithm, bool)

Encripta el documento. Luego llame a Save para obtener la versión encriptada del documento.

public void Encrypt(string userPassword, string ownerPassword, Permissions permissions, CryptoAlgorithm cryptoAlgorithm, bool usePdf20)

Parámetros

userPassword string

Contraseña de usuario.

ownerPassword string

Contraseña de propietario.

permissions Permissions

Permisos del documento, consulte Aspose.Pdf.Document.Permissions para más detalles.

cryptoAlgorithm CryptoAlgorithm

Algoritmo criptográfico, consulte Aspose.Pdf.Document.CryptoAlgorithm para más detalles.

usePdf20 bool

Soporte para la revisión 6 (Extensión 8).

ExportAnnotationsToXfdf(string)

Exporta todas las anotaciones del documento a un archivo XFDF

public void ExportAnnotationsToXfdf(string fileName)

Parámetros

fileName string

Nombre del archivo XFDF

ExportAnnotationsToXfdf(Stream)

Exporta todas las anotaciones del documento en un flujo.

public void ExportAnnotationsToXfdf(Stream stream)

Parámetros

stream Stream

Flujo donde almacenar XFDF.

Flatten()

Elimina todos los campos del documento y coloca sus valores en su lugar.

public void Flatten()

Flatten(FlattenSettings)

Elimina todos los campos (y anotaciones) del documento y coloca sus valores en su lugar.

public void Flatten(Form.FlattenSettings flattenSettings)

Parámetros

flattenSettings Form.FlattenSettings

Configuraciones para el proceso de aplanamiento.

FlattenTransparency()

Reemplaza el contenido transparente con gráficos raster y vectoriales no transparentes.

public void FlattenTransparency()

FreeMemory()

Limpia la memoria

public void FreeMemory()

GetCatalogValue(string)

Devuelve el valor del elemento del diccionario de catálogo.

public object GetCatalogValue(string key)

Parámetros

key string

La clave del elemento.

Devuelve

object

Valor del elemento - si la clave se encontró con éxito; de lo contrario, null.

GetObjectById(string)

Obtiene un objeto con el ID especificado en el documento.

public object GetObjectById(string id)

Parámetros

id string

El id del objeto.

Devuelve

object

El objeto con el id especificado. Null si no se encuentra el id.

GetXmpMetadata(Stream)

Obtiene los metadatos XMP del documento.

public void GetXmpMetadata(Stream stream)

Parámetros

stream Stream

Flujo donde se almacenarán los metadatos.

HasIncrementalUpdate()

Verifica si el documento PDF actual ha sido guardado con actualizaciones incrementales.

public bool HasIncrementalUpdate()

Devuelve

bool

true si el documento PDF tiene actualizaciones incrementales; de lo contrario, false.

ImportAnnotationsFromXfdf(string)

Importa anotaciones desde un archivo XFDF al documento.

public void ImportAnnotationsFromXfdf(string fileName)

Parámetros

fileName string

Nombre del archivo XFDF

ImportAnnotationsFromXfdf(Stream)

Importa anotaciones desde un flujo al documento.

public void ImportAnnotationsFromXfdf(Stream stream)

Parámetros

stream Stream

Flujo que contiene datos XFDF.

LoadFrom(string, LoadOptions)

Carga un archivo, convirtiéndolo a PDF.

public void LoadFrom(string filename, LoadOptions options)

Parámetros

filename string

La ruta al archivo que se abrirá.

options LoadOptions

Las opciones de carga.

Excepciones

PdfException

Si no se puede cargar el archivo.

FileNotFoundException

Si no se encuentra el archivo.

Merge(MergeOptions, params Document[])

Fusiona documentos.

public void Merge(Document.MergeOptions mergeOptions, params Document[] documents)

Parámetros

mergeOptions Document.MergeOptions

Las opciones de fusión.

documents Document[]

Los documentos a fusionar.

Merge(MergeOptions, params string[])

Fusiona documentos.

public void Merge(Document.MergeOptions mergeOptions, params string[] files)

Parámetros

mergeOptions Document.MergeOptions

Las opciones de fusión.

files string[]

Los archivos pdf a fusionar.

Merge(params Document[])

Fusiona documentos.

public void Merge(params Document[] documents)

Parámetros

documents Document[]

Los documentos a fusionar.

Merge(params string[])

Fusiona archivos pdf.

public void Merge(params string[] files)

Parámetros

files string[]

Los archivos pdf a fusionar.

MergeDocuments(MergeOptions, params string[])

Fusiona documentos.

public static Document MergeDocuments(Document.MergeOptions mergeOptions, params string[] files)

Parámetros

mergeOptions Document.MergeOptions

Las opciones de fusión.

files string[]

Los archivos pdf a fusionar.

Devuelve

Document

El documento fusionado.

MergeDocuments(MergeOptions, params Document[])

Fusiona documentos.

public static Document MergeDocuments(Document.MergeOptions mergeOptions, params Document[] files)

Parámetros

mergeOptions Document.MergeOptions

files Document[]

Los documentos a fusionar.

Devuelve

Document

El documento fusionado.

MergeDocuments(params string[])

Fusiona archivos pdf.

public static Document MergeDocuments(params string[] files)

Parámetros

files string[]

Los archivos pdf a fusionar.

Devuelve

Document

El documento fusionado.

MergeDocuments(params Document[])

Fusiona documentos.

public static Document MergeDocuments(params Document[] documents)

Parámetros

documents Document[]

Los documentos a fusionar.

Devuelve

Document

El documento fusionado.

Optimize()

Lineariza el documento para

  • abrir la primera página lo más rápido posible;
  • mostrar la siguiente página o seguir un enlace a la siguiente página lo más rápido posible;
  • mostrar la página de forma incremental a medida que llega cuando los datos de una página se entregan a través de un canal lento (mostrar los datos más útiles primero);
  • permitir la interacción del usuario, como seguir un enlace, que se realice incluso antes de que se haya recibido y mostrado toda la página. Invocar este método no guarda realmente el documento. Por el contrario, el documento solo se prepara para tener una estructura optimizada, llame luego a Save para obtener un documento optimizado.
public void Optimize()

OptimizeResources()

Optimiza los recursos en el documento:

  1. Se eliminan los recursos que no se utilizan en las páginas del documento;
  2. Los recursos iguales se unen en un solo objeto;
  3. Se eliminan los objetos no utilizados.
public void OptimizeResources()

OptimizeResources(OptimizationOptions)

Optimiza los recursos en el documento de acuerdo con la estrategia de optimización definida.

public void OptimizeResources(OptimizationOptions strategy)

Parámetros

strategy OptimizationOptions

Estrategia de optimización.

PageNodesToBalancedTree(byte)

Organiza los nodos del árbol de páginas en un documento en un árbol equilibrado. Solo si el documento tiene más de nodesNumInSubtrees objetos de página, de lo contrario no hace nada. No llame a este método mientras itera sobre elementos Pages, puede dar resultados impredecibles.

public void PageNodesToBalancedTree(byte nodesNumInSubtrees = 10)

Parámetros

nodesNumInSubtrees byte

Número deseado de subnodos. El valor predeterminado es diez.

ProcessParagraphs()

Procesa párrafos para el generador.

public void ProcessParagraphs()

RemoveMetadata()

Elimina los metadatos del documento.

public void RemoveMetadata()

RemovePdfUaCompliance()

Elimina la conformidad pdfUa del documento.

public void RemovePdfUaCompliance()

RemovePdfaCompliance()

Elimina la conformidad pdfa del documento.

public void RemovePdfaCompliance()

Repair()

Repara un documento dañado.

public void Repair()

Save(Stream)

Almacena el documento en un flujo.

public void Save(Stream output)

Parámetros

output Stream

Flujo donde se almacenará el documento.

Save(string)

Guarda el documento en el archivo especificado.

public void Save(string outputFileName)

Parámetros

outputFileName string

Ruta al archivo donde se almacenará el documento.

Save()

Guarda el documento de forma incremental (es decir, utilizando la técnica de actualización incremental).

public void Save()

Observaciones

Para guardar el documento de forma incremental, debemos abrir el archivo del documento para escritura. Por lo tanto, el Documento debe inicializarse con un flujo escribible como en el siguiente fragmento de código: Document doc = new Document(new FileStream(“document.pdf”, FileMode.Open, FileAccess.ReadWrite)); // hacer algunos cambios y guardar el documento de forma incremental doc.Save();

Save(SaveOptions)

Guarda el documento con opciones de guardado.

public void Save(SaveOptions options)

Parámetros

options SaveOptions

Opciones de guardado.

Save(string, SaveFormat)

Guarda el documento con un nuevo nombre junto con un formato de archivo.

public void Save(string outputFileName, SaveFormat format)

Parámetros

outputFileName string

Ruta al archivo donde se almacenará el documento.

format SaveFormat

Opciones de formato.

Save(Stream, SaveFormat)

Guarda el documento con un nuevo nombre junto con un formato de archivo.

public void Save(Stream outputStream, SaveFormat format)

Parámetros

outputStream Stream

Flujo donde se almacenará el documento.

format SaveFormat

Opciones de formato.

Excepciones

ArgumentException

System.ArgumentException cuando se pasa Aspose.Pdf.HtmlSaveOptions a un método. Guardar un documento en el flujo html no es compatible. Por favor, use el método guardar en el archivo.

Save(string, SaveOptions)

Guarda el documento con un nuevo nombre configurando sus opciones de guardado.

public void Save(string outputFileName, SaveOptions options)

Parámetros

outputFileName string

Ruta al archivo donde se almacenará el documento.

options SaveOptions

Opciones de guardado.

Save(Stream, SaveOptions)

Guarda el documento en un flujo con opciones de guardado.

public void Save(Stream outputStream, SaveOptions options)

Parámetros

outputStream Stream

Flujo donde se almacenará el documento.

options SaveOptions

Opciones de guardado.

Excepciones

ArgumentException

System.ArgumentException cuando se pasa Aspose.Pdf.HtmlSaveOptions a un método. Guardar un documento en el flujo html no es compatible. Por favor, use el método guardar en el archivo.

SaveAsync(Stream, CancellationToken)

Almacena el documento en un flujo.

public Task SaveAsync(Stream output, CancellationToken cancellationToken)

Parámetros

output Stream

Flujo donde se almacenará el documento.

cancellationToken CancellationToken

Token de cancelación.

Devuelve

Task

Tarea asincrónica.

SaveAsync(string, CancellationToken)

Guarda el documento en el archivo especificado.

public Task SaveAsync(string outputFileName, CancellationToken cancellationToken)

Parámetros

outputFileName string

Ruta al archivo donde se almacenará el documento.

cancellationToken CancellationToken

Token de cancelación.

Devuelve

Task

Tarea asincrónica.

SaveAsync(CancellationToken)

Guarda el documento de forma incremental (es decir, utilizando la técnica de actualización incremental).

public Task SaveAsync(CancellationToken cancellationToken)

Parámetros

cancellationToken CancellationToken

Token de cancelación.

Devuelve

Task

Tarea asincrónica.

Observaciones

Para guardar el documento de forma incremental debemos abrir el archivo del documento para escritura. Por lo tanto, el Documento debe inicializarse con un flujo escribible como en el siguiente fragmento de código: Document doc = new Document(new FileStream(“document.pdf”, FileMode.Open, FileAccess.ReadWrite)); // hacer algunos cambios y guardar el documento de forma incremental doc.Save();

SaveAsync(SaveOptions, CancellationToken)

Guarda el documento con opciones de guardado.

public Task SaveAsync(SaveOptions options, CancellationToken cancellationToken)

Parámetros

options SaveOptions

Opciones de guardado.

cancellationToken CancellationToken

Token de cancelación.

Devuelve

Task

Tarea asincrónica.

SaveAsync(string, SaveFormat, CancellationToken)

Guarda el documento con un nuevo nombre junto con un formato de archivo.

public Task SaveAsync(string outputFileName, SaveFormat format, CancellationToken cancellationToken)

Parámetros

outputFileName string

Ruta al archivo donde se almacenará el documento.

format SaveFormat

Opciones de formato.

cancellationToken CancellationToken

Token de cancelación.

Devuelve

Task

Tarea asincrónica.

SaveAsync(Stream, SaveFormat, CancellationToken)

Guarda el documento con un nuevo nombre junto con un formato de archivo.

public Task SaveAsync(Stream outputStream, SaveFormat format, CancellationToken cancellationToken)

Parámetros

outputStream Stream

Flujo donde se almacenará el documento.

format SaveFormat

Opciones de formato.

cancellationToken CancellationToken

Token de cancelación.

Devuelve

Task

Tarea asincrónica.

Excepciones

ArgumentException

System.ArgumentException cuando se pasa Aspose.Pdf.HtmlSaveOptions a un método. Guardar un documento en el flujo html no es compatible. Por favor, use el método guardar en el archivo.

SaveAsync(string, SaveOptions, CancellationToken)

Guarda el documento con un nuevo nombre configurando sus opciones de guardado.

public Task SaveAsync(string outputFileName, SaveOptions options, CancellationToken cancellationToken)

Parámetros

outputFileName string

Ruta al archivo donde se almacenará el documento.

options SaveOptions

Opciones de guardado.

cancellationToken CancellationToken

Token de cancelación.

Devuelve

Task

Tarea asincrónica.

SaveAsync(Stream, SaveOptions, CancellationToken)

Guarda el documento en un flujo con opciones de guardado.

public Task SaveAsync(Stream outputStream, SaveOptions options, CancellationToken cancellationToken)

Parámetros

outputStream Stream

Flujo donde se almacenará el documento.

options SaveOptions

Opciones de guardado.

cancellationToken CancellationToken

Token de cancelación.

Devuelve

Task

Tarea asincrónica.

Excepciones

ArgumentException

System.ArgumentException cuando se pasa Aspose.Pdf.HtmlSaveOptions a un método. Guardar un documento en el flujo html no es compatible. Por favor, use el método guardar en el archivo.

SaveXml(string)

Guarda el documento en XML.

public void SaveXml(string file)

Parámetros

file string

El archivo xml del modelo del documento

SendTo(DocumentDevice, Stream)

Envía todo el documento al dispositivo de documento para su procesamiento.

public void SendTo(DocumentDevice device, Stream output)

Parámetros

device DocumentDevice

Dispositivo de documento que se utiliza para procesar el documento.

output Stream

Flujo de salida que contiene los resultados del procesamiento del documento con el dispositivo dado.

SendTo(DocumentDevice, int, int, Stream)

Envía ciertas páginas del documento al dispositivo de documento para su procesamiento.

public void SendTo(DocumentDevice device, int fromPage, int toPage, Stream output)

Parámetros

device DocumentDevice

Dispositivo de documento que se utiliza para procesar el documento.

fromPage int

La primera página para procesar.

toPage int

La última página para procesar.

output Stream

Flujo de salida que contiene los resultados del procesamiento de las páginas del documento con el dispositivo dado.

SendTo(DocumentDevice, string)

Envía todo el documento al dispositivo de documento para su procesamiento.

public void SendTo(DocumentDevice device, string outputFileName)

Parámetros

device DocumentDevice

Dispositivo de documento que se utiliza para procesar el documento.

outputFileName string

Nombre del archivo de salida con los resultados del procesamiento.

SendTo(DocumentDevice, int, int, string)

Envía todo el documento al dispositivo de documento para su procesamiento.

public void SendTo(DocumentDevice device, int fromPage, int toPage, string outputFileName)

Parámetros

device DocumentDevice

Dispositivo de documento que se utiliza para procesar el documento.

fromPage [int](https://learn.microsoft.com/dotnet/api/system.int32

 Español