Compartir a través de

Eliminar un elemento de documento de un paquete

En este tema se muestra cómo usar las clases del SDK de Open XML para Office para quitar un elemento de documento (archivo) de un documento Wordprocessing mediante programación.

Partes de documento y paquetes

Un documento Open XML se almacena como un paquete, cuyo formato está definido por ISO/IEC 29500. El paquete puede incluir varias partes con relaciones entre ellas. La relación entre las partes controla la categoría del documento. Un documento puede definirse como un documento de procesamiento de texto si su elemento de relación de paquete contiene una relación con una parte de documento principal. Si su elemento de relación de paquete contiene una relación con una parte de presentación, puede definirse como un documento de presentación. Si su elemento de relación de paquete contiene una relación con una parte de libro, se define como un documento de hoja de cálculo. En este tema sobre procedimientos se usará un paquete de documentos de procesamiento de texto.

Obtención de un objeto WordprocessingDocument

El ejemplo de código comienza con la apertura de un archivo de paquete pasando un nombre de archivo como argumento a uno de los métodos sobrecargados Open de WordprocessingDocument que toma una cadena y un valor booleano que especifica si el archivo debe abrirse en modo de lectura y escritura o no. En este caso, el valor booleano especifica true que el archivo debe abrirse en modo de lectura y escritura.

using (WordprocessingDocument wordDoc = WordprocessingDocument.Open(document, true))

Con v3.0.0+ el Close() método se ha quitado en favor de confiar en la instrucción using. Garantiza que se llama automáticamente al Dispose() método cuando se alcanza la llave de cierre. El bloque que sigue a la instrucción using establece un ámbito para el objeto que se crea o se nombra en la instrucción using. Dado que la WordprocessingDocument clase del SDK de Open XML guarda y cierra automáticamente el objeto como parte de su IDisposable implementación y, dado Dispose() que se llama automáticamente al salir del bloque, no es necesario llamar Save() explícitamente o siempre que Dispose() use una using instrucción.

Estructura de un documento WordProcessingML

La estructura básica de un WordProcessingML documento consta de los document elementos y body , seguidos de uno o varios elementos de nivel de bloque, como p, que representa un párrafo. Un párrafo contiene uno o varios r elementos. significa r ejecutar, que es una región de texto con un conjunto común de propiedades, como el formato. Una ejecución contiene uno o varios t elementos. El t elemento contiene un intervalo de texto. En el ejemplo de código siguiente se muestra el WordprocessingML marcado de un documento que contiene el texto "Texto de ejemplo".

    <w:document xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">
      <w:body>
        <w:p>
          <w:r>
            <w:t>Example text.</w:t>
          </w:r>
        </w:p>
      </w:body>
    </w:document>

Con el SDK de Open XML, puede crear contenido y estructura de documentos mediante clases fuertemente tipadas que corresponden a WordprocessingML elementos. Encontrará estas clases en el espacio de DocumentFormat.OpenXml.Wordprocessing nombres. En la tabla siguiente se enumeran los nombres de clase de las clases correspondientes a los documentelementos , body, p, ry t .

Elemento de WordprocessingML Open XML SDK (clase) Descripción
<document/> Document El elemento raíz del elemento de documento principal.
<body/> Body El contenedor de las estructuras a nivel de bloque, como párrafos, tablas, anotaciones y otras recogidas en la especificación ISO/IEC 29500.
<p/> Paragraph Un párrafo.
<r/> Run Un segmento.
<t/> Text Un intervalo de texto.

Para obtener más información sobre la estructura general de los elementos y elementos de un documento WordprocessingML, vea Estructura de un documento WordprocessingML.

Elemento settings

El siguiente texto de la especificación ISO/IEC 29500 presenta el elemento settings en un PresentationML paquete.

Este elemento especifica la configuración que se aplica a un documento WordprocessingML. Este elemento es el elemento raíz de la parte Configuración del documento en un documento WordprocessingML.
Ejemplo: considere el siguiente fragmento wordprocessingML para la parte de configuración de un documento:

    <w:settings>
      <w:defaultTabStop w:val="720" />
      <w:characterSpacingControl w:val="dontCompress" />
    </w:settings>

El elemento settings contiene todas las opciones de configuración de este documento. En este caso, las dos opciones aplicadas son incrementos de tabulaciones automáticas de 0,5 pulgadas mediante el elemento defaultTabStop y compresión de espacio en blanco de nivel sin caracteres mediante el elemento characterSpacingControl.

© ISO/IEC 29500: 2016

Funcionamiento del código de ejemplo

Después de abrir el documento, en la using instrucción , como un WordprocessingDocument objeto , se crea una referencia al DocumentSettingsPart elemento. A continuación, se puede comprobar si la parte existe; si es así, elimínela del paquete. En esta instancia, la settings.xml parte se quita del paquete.

MainDocumentPart? mainPart = wordDoc.MainDocumentPart;

if (mainPart is not null && mainPart.DocumentSettingsPart is not null)
{
    mainPart.DeletePart(mainPart.DocumentSettingsPart);
}

Código de ejemplo

A continuación se muestra el ejemplo de código completo en C# y Visual Basic.

// To remove a document part from a package.
static void RemovePart(string document)
{
    using (WordprocessingDocument wordDoc = WordprocessingDocument.Open(document, true))
    {
        MainDocumentPart? mainPart = wordDoc.MainDocumentPart;

        if (mainPart is not null && mainPart.DocumentSettingsPart is not null)
        {
            mainPart.DeletePart(mainPart.DocumentSettingsPart);
        }
    }
}

Vea también

  • Last updated on