Información general sobre elementos XML personalizadosCustom XML parts overview

Puede insertar datos XML en documentos para algunas aplicaciones de Microsoft Office.You can embed XML data in documents for some Microsoft Office applications. Al incrustar datos XML en un documento, los datos se denominan un elemento XML personalizado.When you embed XML data in a document, the data is named a custom XML part.

Puede crear y modificar elementos XML personalizados en un documento mediante un complemento de VSTO o una solución de nivel de documento en Visual Studio.You can create and modify custom XML parts in a document by using a VSTO Add-in or document-level solution in Visual Studio. No es necesario iniciar la aplicación de Microsoft Office para crear y modificar elementos XML personalizados.You do not need to start the Microsoft Office application to create and modify custom XML parts.

Se aplica a: La información de este tema se aplica a los proyectos de nivel de documento y los proyectos de complemento VSTO para Excel, PowerPoint y Word.Applies to: The information in this topic applies to document-level projects and VSTO Add-in projects for Excel, PowerPoint, and Word. Para obtener más información, consulte características disponibles por tipo de aplicación y el proyecto de Office.For more information, see Features available by Office application and project type.

Note

Visual Studio también permite almacenar en memoria caché objetos de datos en las personalizaciones de nivel de documento.Visual Studio also enables you to cache data objects in document-level customizations. Esta característica difiere de los elementos XML personalizados, aunque hay algunas similitudes.This feature is different from custom XML parts, although there are some similarities. Para obtener más información, consulte en caché los datos en las personalizaciones de nivel de documento.For more information, see Cached data in document-level customizations.

Comprender los elementos XML personalizadosUnderstand custom XML parts

Los elementos XML personalizados se introdujeron en 2007 Microsoft Office System, junto con los formatos Open XML.Custom XML parts were introduced in the 2007 Microsoft Office system, along with the Open XML Formats. Estos formatos incluyen nuevos formatos de archivo basado en XML para Excel, PowerPoint y Word (como .xlsx, .pptx, y .docx).These formats include new XML-based file formats for Excel, PowerPoint, and Word (such as .xlsx, .pptx, and .docx). Los documentos en estos formatos constan de archivos XML (también denominado elementos XML) que se organizan en carpetas en un archivo ZIP.Documents in these formats consist of XML files (also named XML parts) that are organized in folders in a ZIP archive. La mayoría de los elementos XML son elementos integrados que ayudan a definir la estructura y el estado del documento.Most of the XML parts are built-in parts that help to define the structure and the state of the document. Sin embargo, los documentos también pueden contener elementos XML personalizados, que puede usar para almacenar datos XML arbitrarios en los documentos.However, documents can also contain custom XML parts, which you can use to store arbitrary XML data in the documents.

El archivo XML da formato a las aplicaciones para trabajar con documentos de maneras que no son posibles con los formatos de archivo binario anteriores (como .xls, .ppt, y .doc).The XML file formats enable applications to work with documents in ways that are not possible with the older binary file formats (such as .xls, .ppt, and .doc). Cualquier aplicación que pueda leer archivos ZIP puede examinar y modificar el contenido de los documentos, incluso si no está instalado Microsoft Office.Any application that can read ZIP archives can examine and modify the contents of the documents, even if Microsoft Office is not installed.

Para obtener más información sobre la estructura de Open XML y elementos XML personalizados, consulte los siguientes artículos:For more information about the structure of Open XML and custom XML parts, see the following articles:

Note

Excel, Word y PowerPoint también permiten usar elementos XML personalizados en documentos guardados en los formatos de archivo binario.Excel, Word, and PowerPoint also enable you to use custom XML parts in documents that are saved in the binary file formats. Sin embargo, si se guarda un documento en un formato binario, no se puede agregar o modificar elementos XML personalizados sin iniciar la aplicación de Microsoft Office.However, if a document is saved in a binary format, you cannot add or modify custom XML parts without starting the Microsoft Office application.

Crear y modificar elementos XML personalizadosCreate and modify custom XML parts

Puede crear o modificar elementos XML personalizados cuando el documento está abierto en la aplicación de Office o cuando está cerrado, incluso si no está instalado Microsoft Office.You can create or modify custom XML parts when the document is open in the Office application, or when the document is closed—even if Microsoft Office is not installed.

Modificar elementos XML mientras se ejecuta la aplicación de OfficeModify XML parts while the Office application is running

Puede trabajar con elementos XML personalizados mediante el uso de una personalización de nivel de documento o un complemento de VSTO.You can work with custom XML parts by using a document-level customization or a VSTO Add-in. Si está usando una personalización de nivel de documento, normalmente trabajará con elementos XML personalizados que se encuentran en el documento personalizado.If you are using a document-level customization, you will typically work with custom XML parts that are in the customized document. Si usas un complemento de VSTO, puede crear o modificar elementos XML personalizados en cualquier documento que está abierto en la aplicación.If you are using a VSTO Add-in, you can create or modify custom XML parts in any document that is open in the application.

Para crear un elemento XML personalizado con Visual Studio, agregue un nuevo CustomXMLPart a la colección CustomXMLParts del documento.To create a custom XML part by using Visual Studio, add a new CustomXMLPart to the CustomXMLParts collection in the document. Para obtener más información, vea los temas siguientes:For more information, see the following topics:

Modificar elementos XML sin iniciar la aplicación de OfficeModify XML parts without starting the Office application

Puede agregar o modificar un elemento XML personalizado sin iniciar Excel, PowerPoint o Word.You can add or modify a custom XML part without starting Excel, PowerPoint, or Word. Esto es útil si desea trabajar con datos XML en un documento en un equipo que no tiene instaladas aplicaciones de Microsoft Office, como un servidor.This is useful if you want to work with XML data in a document on a computer that does not have Microsoft Office applications installed, such as a server.

Para agregar un elemento XML personalizado sin iniciar Microsoft Office, use las clases del SDK de Open XML.To add a custom XML part without starting Microsoft Office, use classes in the Open XML SDK. Estas clases están diseñadas para proporcionar acceso a contenido de Open XML específico de documentos de Office.These classes are designed to provide access to Open XML content that is specific to Office documents. Por ejemplo, para agregar un elemento XML personalizado a un libro de Excel, use el AddNewPart método de un WorkbookPart objeto.For example, to add a custom XML part to an Excel workbook, you use the AddNewPart method of a WorkbookPart object. Para obtener más información, consulte Open XML SDK.For more information, see Open XML SDK.

Enlazar elementos XML personalizados a controles de contenido de WordBind custom XML parts to Word content controls

Puede enlazar controles de contenido en una solución de Word a los elementos de un elemento XML personalizado.You can bind content controls in a Word solution to elements in a custom XML part. Cuando se enlaza un control de contenido a un elemento XML personalizado, los datos del elemento XML personalizado se muestran en la interfaz de usuario (IU) del control de contenido.When a content control is bound to a custom XML part, the data in the custom XML part is displayed in the user interface (UI) of the content control. Si un usuario edita el texto del control, el elemento XML correspondiente se actualiza automáticamente.If a user edits text in the control, the corresponding XML element is automatically updated. De igual forma, si se modifican los valores de los elementos XML personalizados, los controles de contenido que están enlazados a los elementos XML muestran los nuevos datos.Similarly, if element values in the custom XML parts are changed, the content controls that are bound to the XML elements display the new data. Para obtener más información, consulte controles de contenido.For more information, see Content controls.

Vea tambiénSee also