diff --git a/docs/about-the-open-xml-sdk.md b/docs/about-the-open-xml-sdk.md index 90b330d7..b76a0ef8 100644 --- a/docs/about-the-open-xml-sdk.md +++ b/docs/about-the-open-xml-sdk.md @@ -4,7 +4,7 @@ api_name: api_type: - schema ms.assetid: 620e86b5-49f2-43dc-85d4-9c7456c09552 -title: About the Open XML SDK 2.5 for Office +title: About the Open XML SDK for Office ms.suite: office ms.author: o365devx author: o365devx @@ -13,7 +13,7 @@ ms.date: 11/01/2017 ms.localizationpriority: high --- -# About the Open XML SDK 2.5 for Office +# About the Open XML SDK for Office Open XML is an open standard for word-processing documents, presentations, and spreadsheets that can be freely implemented by multiple applications on different platforms. Open XML is designed to faithfully represent existing word-processing documents, presentations, and spreadsheets that are encoded in binary formats defined by Microsoft Office applications. The reason for Open XML is simple: billions of documents now exist but, unfortunately, the information in those documents is tightly coupled with the programs that created them. The purpose of the Open XML standard is to de-couple documents created by Microsoft Office applications so that they can be manipulated by other applications independent of proprietary formats and without the loss of data. @@ -62,24 +62,22 @@ Version 1 of the Open XML SDK simplified the manipulation of Open XML packages. - **Data update** With the Open XML object model, you can easily modify the data in multiple packages. - **Privacy** With a few lines of code, you can remove comments and other personal information from a document before it is distributed. -## Open XML SDK 2.0 for Microsoft Office - -The Open XML SDK 2.0 for Microsoft Office extended the strongly typed class support from the part classes, which are provided in version 1.0, to the XML content in each part. All functions available in version 1.0 are still supported. With version 2.0, you are able to program against the XML content inside the part. The SDK supports programming in the style of LINQ to XML which makes coding against the XML content much easier than the traditional W3C XML DOM programming model. +## Open XML SDK for Microsoft Office The SDK supports the following common tasks/scenarios: - **Strongly Typed Classes and Objects** Instead of relying on generic XML functionality to manipulate XML, which requires that you be aware of element/attribute/value spelling as well as namespaces, you can use the Open XML SDK to accomplish the same solution simply by manipulating objects that represent elements/attributes/values. All schema types are represented as strongly typed Common Language Runtime (CLR) classes and all attribute values as enumerations. - **Content Construction, Search, and Manipulation** The LINQ technology is built directly into the SDK. As a result, you are able to perform functional constructs and lambda expression queries directly on objects representing Open XML elements. In addition, the SDK allows you to easily traverse and manipulate content by providing support for collections of objects, like tables and paragraphs. -- **Validation** The Open XML SDK 2.0 for Microsoft Office provides validation functionality, enabling you to validate Open XML documents against different variations of the Open XML Format. +- **Validation** The Open XML SDK for Microsoft Office provides validation functionality, enabling you to validate Open XML documents against different variations of the Open XML Format. -## Open XML SDK 2.5 for Office +## Open XML SDK for Office -The Open XML SDK 2.5 provides the namespaces and members to support the Microsoft Office 2013. The Open XML SDK 2.5 can also read ISO/IEC 29500 Strict Format files. The Strict format is a subset of the Transitional format that does not include legacy features - this makes it theoretically easier for a new implementer to support since it has a smaller technical footprint. +The Open XML SDK provides the namespaces and members to support the Microsoft Office 2013. The Open XML SDK can also read ISO/IEC 29500 Strict Format files. The Strict format is a subset of the Transitional format that does not include legacy features - this makes it theoretically easier for a new implementer to support since it has a smaller technical footprint. The SDK supports the following common tasks/scenarios: -- **Support of Office 2013 Preview file format** In addition to the Open XML SDK 2.0 for Microsoft Office classes, Open XML SDK 2.5 provides new classes that enable you to write and build applications to manipulate Open XML file extensions of the new Office 2013 features. -- **Reads ISO Strict Document File** Open XML SDK 2.5 can read ISO/IEC 29500 Strict Format files. When the Open XML SDK 2.5 API opens a Strict Format file, each Open XML part in the file is loaded to an **OpenXmlPart** class of the Open XML SDK 2.5 by mapping `https://purl.oclc.org/ooxml/` namespaces to the corresponding `https://schemas.openxmlformats.org/` namespaces. -- **Fixes to the Open XML SDK 2.0 for Microsoft Office** Open XML SDK 2.5 includes fixes to known issues in the Open XML SDK 2.0 for Microsoft Office. These include lost whitespaces in PowerPoint presentations and an issue with the Custom UI in Word documents where a specified argument was reported as being out of the range of valid values. +- **Support of Office 2013 Preview file format** In addition to the Open XML SDK for Microsoft Office classes, Open XML SDK provides new classes that enable you to write and build applications to manipulate Open XML file extensions of the new Office 2013 features. +- **Reads ISO Strict Document File** Open XML SDK can read ISO/IEC 29500 Strict Format files. When the Open XML SDK API opens a Strict Format file, each Open XML part in the file is loaded to an **OpenXmlPart** class of the Open XML SDK by mapping `https://purl.oclc.org/ooxml/` namespaces to the corresponding `https://schemas.openxmlformats.org/` namespaces. +- **Fixes to the Open XML SDK for Microsoft Office** Open XML SDK includes fixes to known issues in the Open XML SDK for Microsoft Office. These include lost whitespaces in PowerPoint presentations and an issue with the Custom UI in Word documents where a specified argument was reported as being out of the range of valid values. -For more information about these and other new features of the Open XML SDK 2.5, see [What's new in the Open XML SDK 2.5 for Office](what-s-new-in-the-open-xml-sdk.md). +For more information about these and other new features of the Open XML SDK, see [What's new in the Open XML SDK for Office](what-s-new-in-the-open-xml-sdk.md). diff --git a/docs/getting-started.md b/docs/getting-started.md index 9b79fb18..5e273c00 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -5,7 +5,7 @@ api_name: api_type: - schema ms.assetid: 7b729dda-bbb6-437e-93d6-7bfe7b8183fa -title: Getting started with the Open XML SDK 2.5 for Office +title: Getting started with the Open XML SDK for Office ms.suite: office ms.author: o365devx @@ -15,15 +15,15 @@ ms.date: 11/01/2017 ms.localizationpriority: high --- -# Getting started with the Open XML SDK 2.5 for Office +# Getting started with the Open XML SDK for Office -The Open XML SDK 2.5 for Office simplifies the task of manipulating Open XML packages and the underlying Open XML schema elements within a package. The classes in the Open XML SDK 2.5 encapsulate many common tasks that developers perform on Open XML packages, so that you can perform complex operations with just a few lines of code. +The Open XML SDK for Office simplifies the task of manipulating Open XML packages and the underlying Open XML schema elements within a package. The classes in the Open XML SDK encapsulate many common tasks that developers perform on Open XML packages, so that you can perform complex operations with just a few lines of code. [!include[Add-ins note](./includes/addinsnote.md)] ## Using the Classes in the Open XML SDK -Using the classes in the Open XML SDK 2.5 is simple. When you have installed the Open XML SDK 2.5, open your existing project or application in Visual Studio, or create a new project or application. Then, in your project or application, add references to the following components. +Using the classes in the Open XML SDK is simple. When you have installed the Open XML SDK, open your existing project or application in Visual Studio, or create a new project or application. Then, in your project or application, add references to the following components. - **DocumentFormat.OpenXml** - **WindowsBase** diff --git a/docs/how-do-i.md b/docs/how-do-i.md index 381b16fc..6eefcc0f 100644 --- a/docs/how-do-i.md +++ b/docs/how-do-i.md @@ -16,8 +16,7 @@ ms.localizationpriority: high --- # How do I... (Open XML SDK) -This section provides how-to topics for working with the Open XML SDK -2.5 for Office. +This section provides how-to topics for working with the Open XML SDK for Office. [!include[Add-ins note](./includes/addinsnote.md)] diff --git a/docs/how-to-accept-all-revisions-in-a-word-processing-document.md b/docs/how-to-accept-all-revisions-in-a-word-processing-document.md index 12015514..5706b83b 100644 --- a/docs/how-to-accept-all-revisions-in-a-word-processing-document.md +++ b/docs/how-to-accept-all-revisions-in-a-word-processing-document.md @@ -16,7 +16,7 @@ ms.localizationpriority: high # Accept all revisions in a word processing document (Open XML SDK) -This topic shows how to use the Open XML SDK 2.5 for Office to accept all revisions in a word processing document programmatically. +This topic shows how to use the Open XML SDK for Office to accept all revisions in a word processing document programmatically. The following assembly directives are required to compile the code in this topic. @@ -71,9 +71,9 @@ The basic document structure of a **WordProcessingML** document consists of the ``` -Using the Open XML SDK 2.5, you can create document structure and content using strongly-typed classes that correspond to **WordprocessingML** elements. You will find these classes in the [DocumentFormat.OpenXml.Wordprocessing](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.aspx) namespace. The following table lists the class names of the classes that correspond to the **document**, **body**, **p**, **r**, and **t** elements. +Using the Open XML SDK, you can create document structure and content using strongly-typed classes that correspond to **WordprocessingML** elements. You will find these classes in the [DocumentFormat.OpenXml.Wordprocessing](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.aspx) namespace. The following table lists the class names of the classes that correspond to the **document**, **body**, **p**, **r**, and **t** elements. -| WordprocessingML Element | Open XML SDK 2.5 Class | Description | +| WordprocessingML Element | Open XML SDK Class | Description | |---|---|---| | document | [Document](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.document.aspx) | The root element for the main document part. | | body | [Body](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.body.aspx) | The container for the block level structures such as paragraphs, tables, annotations and others specified in the [ISO/IEC 29500](https://www.iso.org/standard/71691.html) specification. | @@ -506,4 +506,4 @@ The following is the complete sample code in both C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-add-a-comment-to-a-slide-in-a-presentation.md b/docs/how-to-add-a-comment-to-a-slide-in-a-presentation.md index 8d6837c2..4314f864 100644 --- a/docs/how-to-add-a-comment-to-a-slide-in-a-presentation.md +++ b/docs/how-to-add-a-comment-to-a-slide-in-a-presentation.md @@ -17,7 +17,7 @@ ms.localizationpriority: medium # Add a comment to a slide in a presentation (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to add a comment to the first slide in a presentation programmatically. @@ -138,13 +138,13 @@ two slides denoted by the IDs 267 and 256. ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content using strongly-typed classes that correspond to PresentationML elements. You can find these classes in the [DocumentFormat.OpenXml.Presentation](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.aspx) namespace. The following table lists the class names of the classes that correspond to the **sld**, **sldLayout**, **sldMaster**, and **notesMaster** elements. -| PresentationML Element | Open XML SDK 2.5 Class | Description | +| PresentationML Element | Open XML SDK Class | Description | |---|---|---| | sld | [Slide](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slide.aspx) | Presentation Slide. It is the root element of SlidePart. | | sldLayout | [SlideLayout](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slidelayout.aspx) | Slide Layout. It is the root element of SlideLayoutPart. | @@ -759,5 +759,5 @@ comment string to the first slide in the presentation file Myppt1.pptx. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-add-a-new-document-part-that-receives-a-relationship-id-to-a-package.md b/docs/how-to-add-a-new-document-part-that-receives-a-relationship-id-to-a-package.md index cad271eb..466364a0 100644 --- a/docs/how-to-add-a-new-document-part-that-receives-a-relationship-id-to-a-package.md +++ b/docs/how-to-add-a-new-document-part-that-receives-a-relationship-id-to-a-package.md @@ -17,7 +17,7 @@ ms.localizationpriority: medium # Add a new document part that receives a relationship ID to a package -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to add a document part (file) that receives a relationship **Id** parameter for a word processing document. @@ -77,13 +77,13 @@ markup for a document that contains the text "Example text." ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content using strongly-typed classes that correspond to **WordprocessingML** elements. You will find these classes in the [DocumentFormat.OpenXml.Wordprocessing](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.aspx) namespace. The following table lists the class names of the classes that correspond to the **document**, **body**, **p**, **r**, and **t** elements. -| WordprocessingML Element | Open XML SDK 2.5 Class | Description | +| WordprocessingML Element | Open XML SDK Class | Description | |---|---|---| | document | [Document](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.document.aspx) | The root element for the main document part. | | body | [Body](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.body.aspx) | The container for the block level structures such as paragraphs, tables, annotations and others specified in the ISO/IEC 29500 specification. | @@ -301,7 +301,7 @@ The following is the complete code example in both C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-add-a-new-document-part-to-a-package.md b/docs/how-to-add-a-new-document-part-to-a-package.md index 4e1f2ed6..8dfebac6 100644 --- a/docs/how-to-add-a-new-document-part-to-a-package.md +++ b/docs/how-to-add-a-new-document-part-to-a-package.md @@ -15,7 +15,7 @@ ms.localizationpriority: medium # Add a new document part to a package (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for Office to add a document part (file) to a word processing document programmatically. +This topic shows how to use the classes in the Open XML SDK for Office to add a document part (file) to a word processing document programmatically. The following assembly directives are required to compile the code in this topic. @@ -69,9 +69,9 @@ The basic document structure of a **WordProcessingML** document consists of the ``` -Using the Open XML SDK 2.5, you can create document structure and content using strongly-typed classes that correspond to **WordprocessingML** elements. Find these classes in the **[DocumentFormat.OpenXml.Wordprocessing](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.aspx)** namespace. The following table lists the class names of the classes that correspond to the **document**, **body**, **p**, **r**, and **t** elements, +Using the Open XML SDK, you can create document structure and content using strongly-typed classes that correspond to **WordprocessingML** elements. Find these classes in the **[DocumentFormat.OpenXml.Wordprocessing](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.aspx)** namespace. The following table lists the class names of the classes that correspond to the **document**, **body**, **p**, **r**, and **t** elements, -|**WordprocessingML Element** | **Open XML SDK 2.5 Class** | **Description** | +|**WordprocessingML Element** | **Open XML SDK Class** | **Description** | |:---|:---|:---| | document | [Document](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.document.aspx) | The root element for the main document part. | | body | [Body](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.body.aspx) | The container for the block level structures such as paragraphs, tables, annotations, and others specified in the ISO/IEC 29500 specification. | @@ -163,4 +163,4 @@ Following is the complete code example in both C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-add-custom-ui-to-a-spreadsheet-document.md b/docs/how-to-add-custom-ui-to-a-spreadsheet-document.md index a57cc208..de4945af 100644 --- a/docs/how-to-add-custom-ui-to-a-spreadsheet-document.md +++ b/docs/how-to-add-custom-ui-to-a-spreadsheet-document.md @@ -17,12 +17,11 @@ ms.localizationpriority: high # Add custom UI to a spreadsheet document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for Office to programmatically add custom UI, modifying the ribbon, to an Microsoft Excel 2010 or Microsoft Excel 2013 worksheet. It contains an example **AddCustomUI** method to illustrate +This topic shows how to use the classes in the Open XML SDK for Office to programmatically add custom UI, modifying the ribbon, to an Microsoft Excel 2010 or Microsoft Excel 2013 worksheet. It contains an example **AddCustomUI** method to illustrate this task. -To use the sample code in this topic, you must install the [Open XML SDK 2.0](https://www.nuget.org/packages/DocumentFormat.OpenXml/2.5.0). Explicitly reference the following assemblies in your project: +To use the sample code in this topic, you must install the [Open XML SDK](https://www.nuget.org/packages/DocumentFormat.OpenXml). Explicitly reference the following assemblies in your project: -- WindowsBase - DocumentFormat.OpenXml (installed by the Open XML SDK) You must also use the following **using** directives or **Imports** statements to compile the code in this topic. @@ -39,7 +38,7 @@ You must also use the following **using** directives or **Imports** statements t ## Creating Custom UI -Before using the Open XML SDK 2.5 to create a ribbon customization in an Excel workbook, you must first create the customization content. Describing the XML required to create a ribbon customization is beyond the scope of this topic. In addition, you will find it far easier to use the Ribbon Designer in Visual Studio 2010 to create the customization for you. For more information about customizing the ribbon by using the Visual Studio Ribbon Designer, see [Ribbon Designer](https://msdn.microsoft.com/library/26617206-f4da-416f-a18a-d817b2d4872d(Office.15).aspx) and [Walkthrough: Creating a Custom Tab by Using the Ribbon Designer](https://msdn.microsoft.com/library/312865e6-950f-46ab-88de-fe7eb8036bfe(Office.15).aspx). +Before using the Open XML SDK to create a ribbon customization in an Excel workbook, you must first create the customization content. Describing the XML required to create a ribbon customization is beyond the scope of this topic. In addition, you will find it far easier to use the Ribbon Designer in Visual Studio 2010 to create the customization for you. For more information about customizing the ribbon by using the Visual Studio Ribbon Designer, see [Ribbon Designer](https://msdn.microsoft.com/library/26617206-f4da-416f-a18a-d817b2d4872d(Office.15).aspx) and [Walkthrough: Creating a Custom Tab by Using the Ribbon Designer](https://msdn.microsoft.com/library/312865e6-950f-46ab-88de-fe7eb8036bfe(Office.15).aspx). For the purposes of this demonstration, you will need an XML file that contains a customization, and the following code provides a simple customization (or you can create your own by using the Visual Studio Ribbon Designer, and then right-click to export the customization to an XML file). Copy the following content into a text file that is named AddCustomUI.xml for use as part of this example. This XML content describes a ribbon customization that includes a button labeled "Click Me!" in a group named Group1 on the **Add-Ins** tab in Excel. When you click the button, it attempts to run a macro named **SampleMacro** in the host workbook. ```xml @@ -253,6 +252,6 @@ The following is the complete **AddCustomUI** code sample in C\# and Visual Basi ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) - [Ribbon Designer](https://msdn.microsoft.com/library/26617206-f4da-416f-a18a-d817b2d4872d(Office.15).aspx) - [Walkthrough: Creating a Custom Tab by Using the Ribbon Designer](https://msdn.microsoft.com/library/312865e6-950f-46ab-88de-fe7eb8036bfe(Office.15).aspx) diff --git a/docs/how-to-add-tables-to-word-processing-documents.md b/docs/how-to-add-tables-to-word-processing-documents.md index 8a2703af..18843079 100644 --- a/docs/how-to-add-tables-to-word-processing-documents.md +++ b/docs/how-to-add-tables-to-word-processing-documents.md @@ -16,9 +16,9 @@ ms.localizationpriority: high # Add tables to word processing documents (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for Office to programmatically add a table to a word processing document. It contains an example **AddTable** method to illustrate this task. +This topic shows how to use the classes in the Open XML SDK for Office to programmatically add a table to a word processing document. It contains an example **AddTable** method to illustrate this task. -To use the sample code in this topic, you must install the [Open XML SDK 2.5](https://www.nuget.org/packages/DocumentFormat.OpenXml/2.5.0). You must explicitly reference the following assemblies in your project: +To use the sample code in this topic, you must install the [Open XML SDK](https://www.nuget.org/packages/DocumentFormat.OpenXml). You must explicitly reference the following assemblies in your project: - WindowsBase - DocumentFormat.OpenXml (installed by the Open XML SDK) @@ -381,5 +381,5 @@ The following is the complete **AddTable** code sample in C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-apply-a-style-to-a-paragraph-in-a-word-processing-document.md b/docs/how-to-apply-a-style-to-a-paragraph-in-a-word-processing-document.md index faf6f4ec..70cee955 100644 --- a/docs/how-to-apply-a-style-to-a-paragraph-in-a-word-processing-document.md +++ b/docs/how-to-apply-a-style-to-a-paragraph-in-a-word-processing-document.md @@ -16,9 +16,9 @@ ms.localizationpriority: high # Apply a style to a paragraph in a word processing document -This topic shows how to use the classes in the Open XML SDK 2.5 for Office to programmatically apply a style to a paragraph within a word processing document. It contains an example **ApplyStyleToParagraph** method to illustrate this task, plus several supplemental example methods to check whether a style exists, add a new style, and add the styles part. +This topic shows how to use the classes in the Open XML SDK for Office to programmatically apply a style to a paragraph within a word processing document. It contains an example **ApplyStyleToParagraph** method to illustrate this task, plus several supplemental example methods to check whether a style exists, add a new style, and add the styles part. -To use the sample code in this topic, you must install the [Open XML SDK 2.5](https://www.nuget.org/packages/DocumentFormat.OpenXml/2.5.0). You must explicitly reference the following assemblies in your project: +To use the sample code in this topic, you must install the [Open XML SDK](https://www.nuget.org/packages/DocumentFormat.OpenXml). You must explicitly reference the following assemblies in your project: - WindowsBase - DocumentFormat.OpenXml (installed by the Open XML SDK) @@ -91,9 +91,9 @@ The basic document structure of a WordprocessingML document consists of the **do The XML namespace declaration ("xmlns") is the standard namespace declaration for WordprocessingML, which allows the file to reference elements and attributes that are part of WordprocessingML. By convention, the namespace is associated with the "w" prefix. -The root element is document, which specifies the contents of the main document part in a WordprocessingML document. Using the Open XML SDK 2.5, you can create document structure and content using strongly-typed classes that correspond to WordprocessingML elements. You'll find these classes in the [DocumentFormat.OpenXml.Wordprocessing](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.aspx) namespace. The following table lists the class names of the classes that correspond to the **document**, **body**, **p**, **r**, and **t** elements. +The root element is document, which specifies the contents of the main document part in a WordprocessingML document. Using the Open XML SDK, you can create document structure and content using strongly-typed classes that correspond to WordprocessingML elements. You'll find these classes in the [DocumentFormat.OpenXml.Wordprocessing](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.aspx) namespace. The following table lists the class names of the classes that correspond to the **document**, **body**, **p**, **r**, and **t** elements. -| **WordprocessingML Element** | **Open XML SDK 2.5 Class** | **Description** | +| **WordprocessingML Element** | **Open XML SDK Class** | **Description** | |:---|:---|:---| | document | [Document](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.document.aspx) | The root element for the main document part. | | body | [Body](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.body.aspx) | The container for the block level structures such as paragraphs, tables, annotations and others specified in the [ISO/IEC 29500](https://www.iso.org/standard/71691.html) specification. | @@ -875,4 +875,4 @@ The following is the complete code sample in both C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](\/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](\/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-apply-a-theme-to-a-presentation.md b/docs/how-to-apply-a-theme-to-a-presentation.md index 0ec6c01c..f89e8c8d 100644 --- a/docs/how-to-apply-a-theme-to-a-presentation.md +++ b/docs/how-to-apply-a-theme-to-a-presentation.md @@ -17,7 +17,7 @@ ms.localizationpriority: medium # Apply a theme to a presentation (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to apply the theme from one presentation to another presentation programmatically. @@ -149,13 +149,13 @@ two slides denoted by the ID 267 and 256. ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content using strongly-typed classes that correspond to **PresentationML** elements. You can find these classes in the [DocumentFormat.OpenXml.Presentation](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.aspx) namespace. The following table lists the class names of the classes that correspond to the **sld**, **sldLayout**, **sldMaster**, and **notesMaster** elements. -| PresentationML Element | Open XML SDK 2.5 Class | Description | +| PresentationML Element | Open XML SDK Class | Description | |---|---|---| | sld | Slide | Presentation Slide. It is the root element of SlidePart. | | sldLayout | SlideLayout | Slide Layout. It is the root element of SlideLayoutPart. | @@ -187,7 +187,7 @@ be useful when working with this element. The following table lists the possible child types of the Theme class. -| PresentationML Element | Open XML SDK 2.5 Class | Description | +| PresentationML Element | Open XML SDK Class | Description | |---|---|---| | custClrLst | CustomColorList | Custom Color List | | extLst | ExtensionList | Extension List | @@ -674,7 +674,7 @@ would see the same theme of the file Myppt9-theme.pptx. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-calculate-the-sum-of-a-range-of-cells-in-a-spreadsheet-document.md b/docs/how-to-calculate-the-sum-of-a-range-of-cells-in-a-spreadsheet-document.md index d9fc60de..98ca0079 100644 --- a/docs/how-to-calculate-the-sum-of-a-range-of-cells-in-a-spreadsheet-document.md +++ b/docs/how-to-calculate-the-sum-of-a-range-of-cells-in-a-spreadsheet-document.md @@ -15,7 +15,7 @@ ms.localizationpriority: high # Calculate the sum of a range of cells in a spreadsheet document -This topic shows how to use the classes in the Open XML SDK 2.5 for Office to calculate the sum of a contiguous range of cells in a spreadsheet document programmatically. +This topic shows how to use the classes in the Open XML SDK for Office to calculate the sum of a contiguous range of cells in a spreadsheet document programmatically. The following assembly directives are required to compile the code in this topic. @@ -92,9 +92,9 @@ The worksheet XML files contain one or more block level elements such as **[Shee ``` -Using the Open XML SDK 2.5, you can create document structure and content that uses strongly-typed classes that correspond to **SpreadsheetML** elements. You can find these classes in the **DocumentFormat.OpenXML.Spreadsheet** namespace. The following table lists the class names of the classes that correspond to the **workbook**, **sheets**, **sheet**, **worksheet**, and **sheetData** elements. +Using the Open XML SDK, you can create document structure and content that uses strongly-typed classes that correspond to **SpreadsheetML** elements. You can find these classes in the **DocumentFormat.OpenXML.Spreadsheet** namespace. The following table lists the class names of the classes that correspond to the **workbook**, **sheets**, **sheet**, **worksheet**, and **sheetData** elements. -| SpreadsheetML Element | Open XML SDK 2.5 Class | Description | +| SpreadsheetML Element | Open XML SDK Class | Description | |---|---|---| | workbook | DocumentFormat.OpenXml.Spreadsheet.Workbook | The root element for the main document part. | | sheets | DocumentFormat.OpenXml.Spreadsheet.Sheets | The container for the block level structures such as sheet, fileVersion, and others specified in the [ISO/IEC 29500](https://www.iso.org/standard/71691.html) specification. | @@ -291,7 +291,7 @@ The code then gets the column name by passing a parameter that represents the na End Function ``` -To compare two columns the code passes in two parameters that represent the columns to compare. If the first column is longer than the second column, it returns 1. If the second column is longer than the first column, it returns -1. Otherwise, it compares the values of the columns using the **[Compare](/dotnet/api/system.string.compare?view=net-6.0)** and returns the result. +To compare two columns the code passes in two parameters that represent the columns to compare. If the first column is longer than the second column, it returns 1. If the second column is longer than the first column, it returns -1. Otherwise, it compares the values of the columns using the **[Compare](/dotnet/api/system.string.compare)** and returns the result. ```csharp // Given two columns, compares the columns. @@ -821,7 +821,7 @@ The following is the complete sample code in both C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) - [Language-Integrated Query (LINQ) (C#)](/dotnet/csharp/programming-guide/concepts/linq/) - [Language-Integrated Query (LINQ) (Visual Basic)](/dotnet/visual-basic/programming-guide/concepts/linq/) - [Lambda Expressions (C#)](/dotnet/csharp/language-reference/operators/lambda-expressions) diff --git a/docs/how-to-change-text-in-a-table-in-a-word-processing-document.md b/docs/how-to-change-text-in-a-table-in-a-word-processing-document.md index fb42a460..46e99dca 100644 --- a/docs/how-to-change-text-in-a-table-in-a-word-processing-document.md +++ b/docs/how-to-change-text-in-a-table-in-a-word-processing-document.md @@ -17,7 +17,7 @@ ms.localizationpriority: high # Change text in a table in a word processing document (Open XML SDK) -This topic shows how to use the Open XML SDK 2.5 for Office to programmatically change text in a table in an existing word processing document. +This topic shows how to use the Open XML SDK for Office to programmatically change text in a table in an existing word processing document. The following assembly directives are required to compile the code in this topic. @@ -259,7 +259,7 @@ Following is the complete code example. ## See also -[Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +[Open XML SDK class library reference](/office/open-xml/open-xml-sdk) [How to: Change Text in a Table in a Word Processing Document](https://msdn.microsoft.com/library/documentformat.openxml.wordprocessing.table(office.14).aspx) [Language-Integrated Query (LINQ)](https://msdn.microsoft.com/library/bb397926.aspx) [Extension Methods (C\# Programming Guide)](https://msdn.microsoft.com/library/bb383977.aspx) diff --git a/docs/how-to-change-the-fill-color-of-a-shape-in-a-presentation.md b/docs/how-to-change-the-fill-color-of-a-shape-in-a-presentation.md index 6e94302d..c13fe102 100644 --- a/docs/how-to-change-the-fill-color-of-a-shape-in-a-presentation.md +++ b/docs/how-to-change-the-fill-color-of-a-shape-in-a-presentation.md @@ -17,7 +17,7 @@ ms.localizationpriority: medium # Change the fill color of a shape in a presentation (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 to +This topic shows how to use the classes in the Open XML SDK to change the fill color of a shape on the first slide in a presentation programmatically. @@ -347,7 +347,7 @@ change in the fill color. -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-change-the-print-orientation-of-a-word-processing-document.md b/docs/how-to-change-the-print-orientation-of-a-word-processing-document.md index ff100e47..f5b505b8 100644 --- a/docs/how-to-change-the-print-orientation-of-a-word-processing-document.md +++ b/docs/how-to-change-the-print-orientation-of-a-word-processing-document.md @@ -18,13 +18,13 @@ ms.localizationpriority: medium # Change the print orientation of a word processing document -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to programmatically set the print orientation of a Microsoft Word 2010 or Microsoft Word 2013 document. It contains an example **SetPrintOrientation** method to illustrate this task. -To use the sample code in this topic, you must install the [Open XML SDK -2.5](https://www.nuget.org/packages/DocumentFormat.OpenXml/2.5.0). You +To use the sample code in this topic, you must install the [Open XML SDK] +(https://www.nuget.org/packages/DocumentFormat.OpenXml). You must explicitly reference the following assemblies in your project: - WindowsBase @@ -528,4 +528,4 @@ Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-convert-a-word-processing-document-from-the-docm-to-the-docx-file-format.md b/docs/how-to-convert-a-word-processing-document-from-the-docm-to-the-docx-file-format.md index 17e2fe43..84703680 100644 --- a/docs/how-to-convert-a-word-processing-document-from-the-docm-to-the-docx-file-format.md +++ b/docs/how-to-convert-a-word-processing-document-from-the-docm-to-the-docx-file-format.md @@ -19,14 +19,14 @@ ms.localizationpriority: high # Convert a word processing document from the DOCM to the DOCX file format -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to programmatically convert a Microsoft Word 2010 or Microsoft Word 2013 document that contains VBA code (and has a .docm extension) to a standard document (with a .docx extension). It contains an example **ConvertDOCMtoDOCX** method to illustrate this task. -To use the sample code in this topic, you must install the [Open XML SDK -2.5](https://www.nuget.org/packages/DocumentFormat.OpenXml/2.5.0). You +To use the sample code in this topic, you must install the [Open XML SDK] +(https://www.nuget.org/packages/DocumentFormat.OpenXml). You must explicitly reference the following assemblies in your project: - WindowsBase @@ -97,7 +97,7 @@ see [ISO/IEC 29500-2](https://www.iso.org/iso/iso_catalogue/catalogue_tc/catalog When you create and save a VBA macro in a document, Word adds a new binary part named vbaProject that contains the internal representation of your macro project. The following image from the Document Explorer in -the Open XML SDK 2.5 Productivity Tool for Microsoft Office shows the +the Open XML SDK Productivity Tool for Microsoft Office shows the document parts in a sample document that contains a macro. The vbaProject part is highlighted. @@ -163,7 +163,7 @@ The sample code next verifies that the vbaProject part exists, deletes the part End If ``` -It is not enough to delete the part from the document. You must also convert the document type, internally. The Open XML SDK 2.5 provides a way to perform this task: You can call the document **ChangeDocumentType** method and indicate the new document type (in this case, supply the *WordProcessingDocumentType.Document* enumerated value). +It is not enough to delete the part from the document. You must also convert the document type, internally. The Open XML SDK provides a way to perform this task: You can call the document **ChangeDocumentType** method and indicate the new document type (in this case, supply the *WordProcessingDocumentType.Document* enumerated value). You must also rename the file. However, you cannot do that while the file is open. The using block closes the file at the end of the block. Therefore, you must have some way to indicate to the code after the block that you have modified the file: The **fileChanged** Boolean variable tracks this information for you. @@ -334,4 +334,4 @@ Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-copy-the-contents-of-an-open-xml-package-part-to-a-document-part-in-a-dif.md b/docs/how-to-copy-the-contents-of-an-open-xml-package-part-to-a-document-part-in-a-dif.md index 207d2786..9cfc8829 100644 --- a/docs/how-to-copy-the-contents-of-an-open-xml-package-part-to-a-document-part-in-a-dif.md +++ b/docs/how-to-copy-the-contents-of-an-open-xml-package-part-to-a-document-part-in-a-dif.md @@ -17,7 +17,7 @@ ms.localizationpriority: medium # Copy contents of an Open XML package part to a document part in a different package -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to copy the contents of an Open XML Wordprocessing document part to a document part in a different word-processing document programmatically. @@ -111,13 +111,13 @@ markup for a document that contains the text "Example text." ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content using strongly-typed classes that correspond to **WordprocessingML** elements. You will find these classes in the [DocumentFormat.OpenXml.Wordprocessing](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.aspx) namespace. The following table lists the class names of the classes that correspond to the **document**, **body**, **p**, **r**, and **t** elements. -| WordprocessingML Element | Open XML SDK 2.5 Class | Description | +| WordprocessingML Element | Open XML SDK Class | Description | |---|---|---| | document | [Document](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.document.aspx) | The root element for the main document part. | | body | [Body](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.body.aspx) | The container for the block level structures such as paragraphs, tables, annotations and others specified in the [ISO/IEC 29500](https://www.iso.org/standard/71691.html) specification. | @@ -276,7 +276,7 @@ Following is the complete sample code in both C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-create-a-package.md b/docs/how-to-create-a-package.md index c1c1ae73..3dd124ac 100644 --- a/docs/how-to-create-a-package.md +++ b/docs/how-to-create-a-package.md @@ -17,7 +17,7 @@ ms.localizationpriority: medium # Create a package (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to programmatically create a word processing document package from content in the form of **WordprocessingML** XML markup. @@ -125,13 +125,13 @@ sample code creates is shown in the following code example. ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content using strongly-typed classes that correspond to WordprocessingML elements. You can find these classes in the [DocumentFormat.OpenXml.Wordprocessing](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.aspx) namespace. The following table lists the class names of the classes that correspond to the **document**, **body**, **p**, **r**, and **t** elements: -| WordprocessingML Element | Open XML SDK 2.5 Class | Description | +| WordprocessingML Element | Open XML SDK Class | Description | |---|---|---| | document | [Document](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.document.aspx) | The root element for the main document part. | | body | [Body](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.body.aspx) | The container for the block level structures such as paragraphs, tables, annotations, and others specified in the [ISO/IEC 29500](https://www.iso.org/standard/71691.html) specification. | @@ -311,7 +311,7 @@ Following is the complete sample code in both C\# and Visual Basic. -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-create-a-presentation-document-by-providing-a-file-name.md b/docs/how-to-create-a-presentation-document-by-providing-a-file-name.md index 64f03c44..b0a02240 100644 --- a/docs/how-to-create-a-presentation-document-by-providing-a-file-name.md +++ b/docs/how-to-create-a-presentation-document-by-providing-a-file-name.md @@ -18,10 +18,10 @@ ms.localizationpriority: high # Create a presentation document by providing a file name (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 to +This topic shows how to use the classes in the Open XML SDK to create a presentation document programmatically. -To use the sample code in this topic, you must install the [Open XML SDK 2.5](https://www.nuget.org/packages/DocumentFormat.OpenXml/2.5.0). You +To use the sample code in this topic, you must install the [Open XML SDK](https://www.nuget.org/packages/DocumentFormat.OpenXml). You must explicitly reference the following assemblies in your project: - WindowsBase @@ -57,9 +57,9 @@ the code in this topic. A presentation file, like all files defined by the Open XML standard, consists of a package file container. This is the file that users see in their file explorer; it usually has a .pptx extension. The package file -is represented in the Open XML SDK 2.5 by the [PresentationDocument](https://msdn.microsoft.com/library/office/documentformat.openxml.packaging.presentationdocument.aspx) class. The +is represented in the Open XML SDK by the [PresentationDocument](https://msdn.microsoft.com/library/office/documentformat.openxml.packaging.presentationdocument.aspx) class. The presentation document contains, among other parts, a presentation part. -The presentation part, represented in the Open XML SDK 2.5 by the [PresentationPart](https://msdn.microsoft.com/library/office/documentformat.openxml.packaging.presentationpart.aspx) class, contains the basic +The presentation part, represented in the Open XML SDK by the [PresentationPart](https://msdn.microsoft.com/library/office/documentformat.openxml.packaging.presentationpart.aspx) class, contains the basic *PresentationML* definition for the slide presentation. PresentationML is the markup language used for creating presentations. Each package can contain only one presentation part, and its root element must be @@ -104,7 +104,7 @@ slide layout, slide master, and theme parts. } ``` -Using the Open XML SDK 2.5, you can create presentation structure and +Using the Open XML SDK, you can create presentation structure and content by using strongly-typed classes that correspond to PresentationML elements. You can find these classes in the [DocumentFormat.OpenXml.Presentation](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.aspx) namespace. The following table lists the names of the classes that @@ -113,7 +113,7 @@ theme elements. The class that corresponds to the theme element is actually part of the [DocumentFormat.OpenXml.Drawing](https://msdn.microsoft.com/library/office/documentformat.openxml.drawing.aspx) namespace. Themes are common to all Open XML markup languages. -| PresentationML Element | Open XML SDK 2.5 Class | +| PresentationML Element | Open XML SDK Class | |---|---| | <presentation> | [Presentation](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.presentation.aspx) | | <sld> | [Slide](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slide.aspx) | @@ -775,7 +775,7 @@ presentation, given a file path. ## See also -[About the Open XML SDK 2.5 for Office](about-the-open-xml-sdk.md) +[About the Open XML SDK for Office](about-the-open-xml-sdk.md) [Structure of a PresentationML Document](structure-of-a-presentationml-document.md) @@ -787,4 +787,4 @@ presentation, given a file path. [How to: Apply a theme to a presentation (Open XML SDK)](how-to-apply-a-theme-to-a-presentation.md) -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-create-a-spreadsheet-document-by-providing-a-file-name.md b/docs/how-to-create-a-spreadsheet-document-by-providing-a-file-name.md index 25ce6133..4dae0344 100644 --- a/docs/how-to-create-a-spreadsheet-document-by-providing-a-file-name.md +++ b/docs/how-to-create-a-spreadsheet-document-by-providing-a-file-name.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Create a spreadsheet document by providing a file name (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to programmatically create a spreadsheet document. The following assembly directives are required to compile the code in @@ -120,13 +120,13 @@ worksheet created by the sample code. ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content by using strongly-typed classes that correspond to SpreadsheetML elements. You can find these classes in the **DocumentFormat.OpenXml.Spreadsheet** namespace. The following table lists the class names of the classes that correspond to the **workbook**, **sheets**, **sheet**, **worksheet**, and **sheetData** elements. -| SpreadsheetML Element | Open XML SDK 2.5 Class | Description | +| SpreadsheetML Element | Open XML SDK Class | Description | |---|---|---| | workbook | DocumentFormat.OpenXml.Spreadsheet.Workbook | The root element for the main document part. | | sheets | DocumentFormat.OpenXml.Spreadsheet.Sheets | The container for the block-level structures such as sheet, fileVersion, and others specified in the [ISO/IEC 29500](https://www.iso.org/standard/71691.html) specification. | @@ -236,4 +236,4 @@ Following is the complete sample code in both C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-create-a-word-processing-document-by-providing-a-file-name.md b/docs/how-to-create-a-word-processing-document-by-providing-a-file-name.md index a74f0dd0..1dd87a13 100644 --- a/docs/how-to-create-a-word-processing-document-by-providing-a-file-name.md +++ b/docs/how-to-create-a-word-processing-document-by-providing-a-file-name.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Create a word processing document by providing a file name -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to programmatically create a word processing document. The following assembly directives are required to compile the code in @@ -118,13 +118,13 @@ example. ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content using strongly-typed classes that correspond to WordprocessingML elements. You can find these classes in the [DocumentFormat.OpenXml.Wordprocessing](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.aspx) namespace. The following table lists the class names of the classes that correspond to the **document**, **body**, **p**, **r**, and **t** elements. -| WordprocessingML Element | Open XML SDK 2.5 Class | Description | +| WordprocessingML Element | Open XML SDK Class | Description | |---|---|---| | document | [Document](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.document.aspx) | The root element for the main document part. | | body | [Body](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.body.aspx) | The container for the block level structures such as paragraphs, tables, annotations, and others specified in the [ISO/IEC 29500](https://www.iso.org/standard/71691.html) specification. | @@ -223,4 +223,4 @@ Following is the complete code example in both C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-create-and-add-a-character-style-to-a-word-processing-document.md b/docs/how-to-create-and-add-a-character-style-to-a-word-processing-document.md index 81cf518c..a61412ef 100644 --- a/docs/how-to-create-and-add-a-character-style-to-a-word-processing-document.md +++ b/docs/how-to-create-and-add-a-character-style-to-a-word-processing-document.md @@ -17,13 +17,13 @@ ms.localizationpriority: medium --- # Create and add a character style to a word processing document -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to programmatically create and add a character style to a word processing document. It contains an example **CreateAndAddCharacterStyle** method to illustrate this task, plus a supplemental example method to add the styles part when it is necessary. -To use the sample code in this topic, you must install the [Open XML SDK 2.5](https://www.nuget.org/packages/DocumentFormat.OpenXml/2.5.0). You +To use the sample code in this topic, you must install the [Open XML SDK](https://www.nuget.org/packages/DocumentFormat.OpenXml). You must explicitly reference the following assemblies in your project: - WindowsBase @@ -629,4 +629,4 @@ The following is the complete **CreateAndAddCharacterStyle** code sample in both ## See also [How to: Apply a style to a paragraph in a word processing document (Open XML SDK)](how-to-apply-a-style-to-a-paragraph-in-a-word-processing-document.md) -[Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +[Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-create-and-add-a-paragraph-style-to-a-word-processing-document.md b/docs/how-to-create-and-add-a-paragraph-style-to-a-word-processing-document.md index 8fa0c998..3469a079 100644 --- a/docs/how-to-create-and-add-a-paragraph-style-to-a-word-processing-document.md +++ b/docs/how-to-create-and-add-a-paragraph-style-to-a-word-processing-document.md @@ -17,14 +17,14 @@ ms.localizationpriority: high --- # Create and add a paragraph style to a word processing document -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to programmatically create and add a paragraph style to a word processing document. It contains an example **CreateAndAddParagraphStyle** method to illustrate this task, plus a supplemental example method to add the styles part when necessary. -To use the sample code in this topic, you must install the [Open XML SDK -2.5](https://www.nuget.org/packages/DocumentFormat.OpenXml/2.5.0). You +To use the sample code in this topic, you must install the [Open XML SDK] +(https://www.nuget.org/packages/DocumentFormat.OpenXml). You must also explicitly reference the following assemblies in your project: - WindowsBase @@ -731,4 +731,4 @@ C\# and Visual Basic. ## See also - [Apply a style to a paragraph in a word processing document (Open XML SDK)](how-to-apply-a-style-to-a-paragraph-in-a-word-processing-document.md) -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-delete-a-slide-from-a-presentation.md b/docs/how-to-delete-a-slide-from-a-presentation.md index 85173178..73896f29 100644 --- a/docs/how-to-delete-a-slide-from-a-presentation.md +++ b/docs/how-to-delete-a-slide-from-a-presentation.md @@ -16,7 +16,7 @@ ms.localizationpriority: medium --- # Delete a slide from a presentation (Open XML SDK) -This topic shows how to use the Open XML SDK 2.5 for Office to delete a +This topic shows how to use the Open XML SDK for Office to delete a slide from a presentation programmatically. It also shows how to delete all references to the slide from any custom shows that may exist. To delete a specific slide in a presentation file you need to know first @@ -153,9 +153,9 @@ two slides denoted by the IDs 267 and 256. ``` -Using the Open XML SDK 2.5, you can create document structure and content using strongly-typed classes that correspond to PresentationML elements. You can find these classes in the **[DocumentFormat.OpenXml.Presentation](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.aspx)** namespace. The following table lists the class names of the classes that correspond to the **sld**, **sldLayout**, **sldMaster**, and **notesMaster** elements. +Using the Open XML SDK, you can create document structure and content using strongly-typed classes that correspond to PresentationML elements. You can find these classes in the **[DocumentFormat.OpenXml.Presentation](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.aspx)** namespace. The following table lists the class names of the classes that correspond to the **sld**, **sldLayout**, **sldMaster**, and **notesMaster** elements. -| PresentationML Element | Open XML SDK 2.5 Class | Description | +| PresentationML Element | Open XML SDK Class | Description | |---|---|---| | sld | [Slide](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slide.aspx) | Presentation Slide. It is the root element of SlidePart. | | sldLayout | [SlideLayout](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slidelayout.aspx) | Slide Layout. It is the root element of SlideLayoutPart. | @@ -718,4 +718,4 @@ Following is the complete sample code in both C\# and Visual Basic. -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentatio.md b/docs/how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentatio.md index f06032c6..87a7916b 100644 --- a/docs/how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentatio.md +++ b/docs/how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentatio.md @@ -16,7 +16,7 @@ ms.localizationpriority: medium --- # Delete all the comments by an author from all the slides in a presentation -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to delete all of the comments by a specific author in a presentation programmatically. @@ -147,13 +147,13 @@ two slides denoted by the ID numbers 267 and 256. ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content using strongly-typed classes that correspond to **PresentationML** elements. You can find these classes in the [DocumentFormat.OpenXml.Presentation](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.aspx) namespace. The following table lists the class names of the classes that correspond to the **sld**, **sldLayout**, **sldMaster**, and **notesMaster** elements: -| PresentationML Element | Open XML SDK 2.5 Class | Description | +| PresentationML Element | Open XML SDK Class | Description | |---|---|---| | sld | [Slide](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slide.aspx) | Presentation Slide. It is the root element of SlidePart. | | sldLayout | [SlideLayout](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slidelayout.aspx) | Slide Layout. It is the root element of SlideLayoutPart. | @@ -443,4 +443,4 @@ The following is the complete sample code in both C\# and Visual Basic. -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-delete-comments-by-all-or-a-specific-author-in-a-word-processing-document.md b/docs/how-to-delete-comments-by-all-or-a-specific-author-in-a-word-processing-document.md index 5046bdcb..378c41b3 100644 --- a/docs/how-to-delete-comments-by-all-or-a-specific-author-in-a-word-processing-document.md +++ b/docs/how-to-delete-comments-by-all-or-a-specific-author-in-a-word-processing-document.md @@ -17,12 +17,12 @@ ms.localizationpriority: medium --- # Delete comments by all or a specific author in a word processing document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to programmatically delete comments by all or a specific author in a word processing document, without having to load the document into Microsoft Word. It contains an example **DeleteComments** method to illustrate this task. -To use the sample code in this topic, you must install the [Open XML SDK 2.5](https://www.nuget.org/packages/DocumentFormat.OpenXml/2.5.0). You +To use the sample code in this topic, you must install the [Open XML SDK](https://www.nuget.org/packages/DocumentFormat.OpenXml). You must explicitly reference the following assemblies in your project: - WindowsBase @@ -483,4 +483,4 @@ The following is the complete code sample in both C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-delete-text-from-a-cell-in-a-spreadsheet.md b/docs/how-to-delete-text-from-a-cell-in-a-spreadsheet.md index 27403f0c..72d0d30c 100644 --- a/docs/how-to-delete-text-from-a-cell-in-a-spreadsheet.md +++ b/docs/how-to-delete-text-from-a-cell-in-a-spreadsheet.md @@ -15,7 +15,7 @@ ms.localizationpriority: high --- # Delete text from a cell in a spreadsheet document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to delete text from a cell in a spreadsheet document programmatically. @@ -102,13 +102,13 @@ code example. ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content that uses strongly-typed classes that correspond to **SpreadsheetML** elements. You can find these classes in the **DocumentFormat.OpenXML.Spreadsheet** namespace. The following table lists the class names of the classes that correspond to the **workbook**, **sheets**, **sheet**, **worksheet**, and **sheetData** elements. -| **SpreadsheetML Element** | **Open XML SDK 2.5 Class** | **Description** | +| **SpreadsheetML Element** | **Open XML SDK Class** | **Description** | |:---|:---|:---| | workbook | DocumentFormat.OpenXML.Spreadsheet.Workbook | The root element for the main document part. | | sheets | DocumentFormat.OpenXML.Spreadsheet.Sheets | The container for the block level structures such as sheet, fileVersion, and others specified in the [ISO/IEC 29500](https://www.iso.org/standard/71691.html) specification. | @@ -605,7 +605,7 @@ The following is the complete code sample in both C\# and Visual Basic. ## See also -[Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +[Open XML SDK class library reference](/office/open-xml/open-xml-sdk) [Language-Integrated Query (LINQ)](https://msdn.microsoft.com/library/bb397926.aspx) [Lambda Expressions](https://msdn.microsoft.com/library/bb531253.aspx) [Lambda Expressions (C\# Programming Guide)](https://msdn.microsoft.com/library/bb397687.aspx) diff --git a/docs/how-to-extract-styles-from-a-word-processing-document.md b/docs/how-to-extract-styles-from-a-word-processing-document.md index 6a3cf8b6..3f5f2eaa 100644 --- a/docs/how-to-extract-styles-from-a-word-processing-document.md +++ b/docs/how-to-extract-styles-from-a-word-processing-document.md @@ -17,15 +17,15 @@ ms.localizationpriority: medium --- # Extract styles from a word processing document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to programmatically extract the styles or stylesWithEffects part from a word processing document to an [XDocument](https://msdn.microsoft.com/library/Bb345449(v=VS.100).aspx) instance. It contains an example **ExtractStylesPart** method to illustrate this task. -To use the sample code in this topic, you must install the [Open XML SDK -2.5](https://www.nuget.org/packages/DocumentFormat.OpenXml/2.5.0). You +To use the sample code in this topic, you must install the [Open XML SDK] +(https://www.nuget.org/packages/DocumentFormat.OpenXml). You must explicitly reference the following assemblies in your project: - WindowsBase @@ -338,4 +338,4 @@ The following is the complete **ExtractStylesPart** code sample in C\# and Visua ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-get-a-column-heading-in-a-spreadsheet.md b/docs/how-to-get-a-column-heading-in-a-spreadsheet.md index a07aaee9..88af3177 100644 --- a/docs/how-to-get-a-column-heading-in-a-spreadsheet.md +++ b/docs/how-to-get-a-column-heading-in-a-spreadsheet.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Get a column heading in a spreadsheet document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to retrieve a column heading in a spreadsheet document programmatically. @@ -112,13 +112,13 @@ Sheet1.xml file and is shown in the following code example. ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content that uses strongly-typed classes that correspond to **SpreadsheetML** elements. You can find these classes in the **DocumentFormat.OpenXML.Spreadsheet** namespace. The following table lists the class names of the classes that correspond to the **workbook**, **sheets**, **sheet**, **worksheet**, and **sheetData** elements. -| SpreadsheetML Element | Open XML SDK 2.5 Class | Description | +| SpreadsheetML Element | Open XML SDK Class | Description | |---|---|---| | workbook | **Workbook** | The root element for the main document part. | | sheets | DocumentFormat.OpenXml.Spreadsheet.Sheets | The container for the block level structures such as sheet, fileVersion, and others specified in the [ISO/IEC 29500](https://www.iso.org/standard/71691.html) specification. | @@ -410,7 +410,7 @@ Following is the complete sample code in both C\# and Visual Basic. -[Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +[Open XML SDK class library reference](/office/open-xml/open-xml-sdk) [Language-Integrated Query (LINQ)](https://msdn.microsoft.com/library/bb397926.aspx) diff --git a/docs/how-to-get-all-the-external-hyperlinks-in-a-presentation.md b/docs/how-to-get-all-the-external-hyperlinks-in-a-presentation.md index 6cfe6dbd..1e1cda07 100644 --- a/docs/how-to-get-all-the-external-hyperlinks-in-a-presentation.md +++ b/docs/how-to-get-all-the-external-hyperlinks-in-a-presentation.md @@ -16,7 +16,7 @@ ms.localizationpriority: medium --- # Get all the external hyperlinks in a presentation (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to get all the external hyperlinks in a presentation programmatically. @@ -143,13 +143,13 @@ two slides denoted by the ID 267 and 256. ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content using strongly-typed classes that correspond to **PresentationML** elements. You can find these classes in the [DocumentFormat.OpenXml.Presentation](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.aspx) namespace. The following table lists the class names of the classes that correspond to the **sld**, **sldLayout**, **sldMaster**, and **notesMaster** elements. -| PresentationML Element | Open XML SDK 2.5 Class | Description | +| PresentationML Element | Open XML SDK Class | Description | |---|---|---| | sld | [Slide](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slide.aspx) | Presentation Slide. It is the root element of SlidePart. | | sldLayout | [SlideLayout](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slidelayout.aspx) | Slide Layout. It is the root element of SlideLayoutPart. | @@ -356,4 +356,4 @@ get the list of URIs in your presentation. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-get-all-the-text-in-a-slide-in-a-presentation.md b/docs/how-to-get-all-the-text-in-a-slide-in-a-presentation.md index ce835395..b11ff44b 100644 --- a/docs/how-to-get-all-the-text-in-a-slide-in-a-presentation.md +++ b/docs/how-to-get-all-the-text-in-a-slide-in-a-presentation.md @@ -16,7 +16,7 @@ ms.localizationpriority: medium --- # Get all the text in a slide in a presentation (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to get all the text in a slide in a presentation programmatically. @@ -149,13 +149,13 @@ two slides denoted by the ID 267 and 256. ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content using strongly-typed classes that correspond to **PresentationML** elements. You can find these classes in the [DocumentFormat.OpenXml.Presentation](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.aspx) namespace. The following table lists the class names of the classes that correspond to the **sld**, **sldLayout**, **sldMaster**, and **notesMaster** elements. -| PresentationML Element | Open XML SDK 2.5 Class | Description | +| PresentationML Element | Open XML SDK Class | Description | |---|---|---| | sld | Slide | Presentation Slide. It is the root element of SlidePart. | | sldLayout | SlideLayout | Slide Layout. It is the root element of SlideLayoutPart. | @@ -631,4 +631,4 @@ Following is the complete sample code in both C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-get-all-the-text-in-all-slides-in-a-presentation.md b/docs/how-to-get-all-the-text-in-all-slides-in-a-presentation.md index c6c38521..cf05b97a 100644 --- a/docs/how-to-get-all-the-text-in-all-slides-in-a-presentation.md +++ b/docs/how-to-get-all-the-text-in-all-slides-in-a-presentation.md @@ -16,7 +16,7 @@ ms.localizationpriority: medium --- # Get all the text in all slides in a presentation (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 to get +This topic shows how to use the classes in the Open XML SDK to get all of the text in all of the slides in a presentation programmatically. The following assembly directives are required to compile the code in @@ -151,13 +151,13 @@ two slides denoted by the ID 267 and 256. ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content using strongly-typed classes that correspond to **PresentationML** elements. You can find these classes in the [DocumentFormat.OpenXml.Presentation](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.aspx) namespace. The following table lists the class names of the classes that correspond to the **sld**, **sldLayout**, **sldMaster**, and **notesMaster** elements. -| PresentationML Element | Open XML SDK 2.5 Class | Description | +| PresentationML Element | Open XML SDK Class | Description | |---|---|---| | sld | [Slide](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slide.aspx) | Presentation Slide. It is the root element of SlidePart. | | sldLayout | [SlideLayout](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slidelayout.aspx) | Slide Layout. It is the root element of SlideLayoutPart. | @@ -446,5 +446,5 @@ The following is the complete sample code in both C\# and Visual Basic. ## See also -[Open XML SDK 2.5 class library +[Open XML SDK class library reference](https://msdn.microsoft.com/library/36c8a76e-ce1b-5959-7e85-5d77db7f46d6(Office.15).aspx) diff --git a/docs/how-to-get-the-contents-of-a-document-part-from-a-package.md b/docs/how-to-get-the-contents-of-a-document-part-from-a-package.md index a8e33617..d974a5cd 100644 --- a/docs/how-to-get-the-contents-of-a-document-part-from-a-package.md +++ b/docs/how-to-get-the-contents-of-a-document-part-from-a-package.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Get the contents of a document part from a package (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to retrieve the contents of a document part in a Wordprocessing document programmatically. @@ -108,13 +108,13 @@ sample code creates is shown in the following code example. ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content using strongly-typed classes that correspond to **WordprocessingML** elements. You can find these classes in the [DocumentFormat.OpenXml.Wordprocessing](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.aspx) namespace. The following table lists the class names of the classes that correspond to the **document**, **body**, **p**, **r**, and **t** elements. -| WordprocessingML Element | Open XML SDK 2.5 Class | Description | +| WordprocessingML Element | Open XML SDK Class | Description | |---|---|---| | document | [Document](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.document.aspx) | The root element for the main document part. | | body | [Body](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.body.aspx) | The container for the block level structures such as paragraphs, tables, annotations, and others specified in the [ISO/IEC 29500](https://www.iso.org/standard/71691.html) specification. | @@ -263,5 +263,5 @@ Following is the complete code example in both C\# and Visual Basic. ## See also -[Open XML SDK 2.5 class library +[Open XML SDK class library reference](https://msdn.microsoft.com/library/36c8a76e-ce1b-5959-7e85-5d77db7f46d6(Office.15).aspx) diff --git a/docs/how-to-get-the-titles-of-all-the-slides-in-a-presentation.md b/docs/how-to-get-the-titles-of-all-the-slides-in-a-presentation.md index 56591774..76a5655d 100644 --- a/docs/how-to-get-the-titles-of-all-the-slides-in-a-presentation.md +++ b/docs/how-to-get-the-titles-of-all-the-slides-in-a-presentation.md @@ -16,7 +16,7 @@ ms.localizationpriority: medium --- # Get the titles of all the slides in a presentation (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to get the titles of all slides in a presentation programmatically. @@ -149,13 +149,13 @@ two slides denoted by the Id's 267 and 256. ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content using strongly-typed classes that correspond to PresentationML elements. You can find these classes in the **[DocumentFormat.OpenXml.Presentation](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.aspx)** namespace. The following table lists the class names of the classes that correspond to the **sld**, **sldLayout**, **sldMaster**, and **notesMaster** elements: -| PresentationML Element | Open XML SDK 2.5 Class | Description | +| PresentationML Element | Open XML SDK Class | Description | |---|---|---| | sld | [Slide](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slide.aspx) | Presentation Slide. It is the root element of SlidePart. | | sldLayout | [SlideLayout](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slidelayout.aspx) | Slide Layout. It is the root element of SlideLayoutPart. | @@ -675,5 +675,5 @@ Following is the complete sample code in both C\# and Visual Basic. -[Open XML SDK 2.5 class library +[Open XML SDK class library reference](https://msdn.microsoft.com/library/36c8a76e-ce1b-5959-7e85-5d77db7f46d6(Office.15).aspx) diff --git a/docs/how-to-get-worksheet-information-from-a-package.md b/docs/how-to-get-worksheet-information-from-a-package.md index 85781616..84d9773f 100644 --- a/docs/how-to-get-worksheet-information-from-a-package.md +++ b/docs/how-to-get-worksheet-information-from-a-package.md @@ -15,7 +15,7 @@ ms.localizationpriority: high # Get worksheet information from an Open XML package (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for Office to programmatically retrieve information from a worksheet in a Spreadsheet document. +This topic shows how to use the classes in the Open XML SDK for Office to programmatically retrieve information from a worksheet in a Spreadsheet document. The following assembly directives are required to compile the code in this topic. @@ -37,9 +37,9 @@ The following assembly directives are required to compile the code in this topic ## Create SpreadsheetDocument object -In the Open XML SDK, the **[SpreadsheetDocument](/dotnet/api/documentformat.openxml.packaging.spreadsheetdocument?)** class represents an Excel document package. To create an Excel document, you create an instance of the **SpreadsheetDocument** class and populate it with parts. At a minimum, the document must have a workbook part that serves as a container for the document, and at least one worksheet part. The text is represented in the package as XML using **SpreadsheetML** markup. +In the Open XML SDK, the **[SpreadsheetDocument](/dotnet/api/documentformat.openxml.packaging.spreadsheetdocument)** class represents an Excel document package. To create an Excel document, you create an instance of the **SpreadsheetDocument** class and populate it with parts. At a minimum, the document must have a workbook part that serves as a container for the document, and at least one worksheet part. The text is represented in the package as XML using **SpreadsheetML** markup. -To create the class instance from the document you call one of the **[Open](/dotnet/api/documentformat.openxml.packaging.spreadsheetdocument.open.md)** methods. In this example, you must open the file for read access only. Therefore, you can use the **[Open(String, Boolean)](dotnet/api/documentformat.openxml.packaging.spreadsheetdocument.open?view=openxml-2.8.1&preserve-view=true #DocumentFormat_OpenXml_Packaging_SpreadsheetDocument_Open_System_String_System_Boolean_)** method, and set the Boolean parameter to **false**. +To create the class instance from the document you call one of the **[Open](/dotnet/api/documentformat.openxml.packaging.spreadsheetdocument.open)** methods. In this example, you must open the file for read access only. Therefore, you can use the **[Open(String, Boolean)](/dotnet/api/documentformat.openxml.packaging.spreadsheetdocument.open#DocumentFormat_OpenXml_Packaging_SpreadsheetDocument_Open_System_String_System_Boolean_)** method, and set the Boolean parameter to **false**. The following code example calls the **Open** method to open the file specified by the **filepath** for read-only access. @@ -57,9 +57,9 @@ The **using** statement provides a recommended alternative to the typical .Open, ## Basic structure of a SpreadsheetML -The basic document structure of a **SpreadsheetML** document consists of the **[Sheets](/dotnet/api/documentformat.openxml.spreadsheet.sheets?view=openxml-2.8.1&preserve-view=true)** and **[Sheet](/dotnet/api/documentformat.openxml.spreadsheet.sheet?view=openxml-2.8.1&preserve-view=true)** elements, which reference the -worksheets in the **[Workbook](/dotnet/api/documentformat.openxml.spreadsheet.workbook?view=openxml-2.8.1&preserve-view=true)**. A separate XML file is created -for each **[Worksheet](/dotnet/api/documentformat.openxml.spreadsheet.worksheet?view=openxml-2.8.1&preserve-view=true)**. For example, the **SpreadsheetML** for a workbook that has two worksheets name MySheet1 and MySheet2 is located in the Workbook.xml file and is shown in the following code example. +The basic document structure of a **SpreadsheetML** document consists of the **[Sheets](/dotnet/api/documentformat.openxml.spreadsheet.sheets)** and **[Sheet](/dotnet/api/documentformat.openxml.spreadsheet.sheet)** elements, which reference the +worksheets in the **[Workbook](/dotnet/api/documentformat.openxml.spreadsheet.workbook)**. A separate XML file is created +for each **[Worksheet](/dotnet/api/documentformat.openxml.spreadsheet.worksheet)**. For example, the **SpreadsheetML** for a workbook that has two worksheets name MySheet1 and MySheet2 is located in the Workbook.xml file and is shown in the following code example. ```xml @@ -71,7 +71,7 @@ for each **[Worksheet](/dotnet/api/documentformat.openxml.spreadsheet.worksheet? ``` -The worksheet XML files contain one or more block level elements such as **SheetData**. **[SheetData](/dotnet/api/documentformat.openxml.spreadsheet.sheetdata?view=openxml-2.8.1&preserve-view=true)** represents the cell table and contains one or more **[Row](/dotnet/api/documentformat.openxml.spreadsheet.row?view=openxml-2.8.1&preserve-view=true )** elements. A **row** contains one or more **[Cell](/dotnet/api/documentformat.openxml.spreadsheet.cell?view=openxml-2.8.1&preserve-view=true)** elements. Each cell contains a **[CellValue](/dotnet/api/documentformat.openxml.spreadsheet.cellvalue?view=openxml-2.8.1&preserve-view=true)** element that represents the value of the cell. For example, the SpreadsheetML for the first worksheet in a workbook, that only has the value 100 in cell A1, is located in the Sheet1.xml file and is shown in the following code example. +The worksheet XML files contain one or more block level elements such as **SheetData**. **[SheetData](/dotnet/api/documentformat.openxml.spreadsheet.sheetdata)** represents the cell table and contains one or more **[Row](/dotnet/api/documentformat.openxml.spreadsheet.row )** elements. A **row** contains one or more **[Cell](/dotnet/api/documentformat.openxml.spreadsheet.cell)** elements. Each cell contains a **[CellValue](/dotnet/api/documentformat.openxml.spreadsheet.cellvalue)** element that represents the value of the cell. For example, the SpreadsheetML for the first worksheet in a workbook, that only has the value 100 in cell A1, is located in the Sheet1.xml file and is shown in the following code example. ```xml @@ -86,10 +86,10 @@ The worksheet XML files contain one or more block level elements such as **Sheet ``` -Using the Open XML SDK 2.5, you can create document structure and content that uses strongly-typed classes that correspond to **SpreadsheetML** elements. You can find these +Using the Open XML SDK, you can create document structure and content that uses strongly-typed classes that correspond to **SpreadsheetML** elements. You can find these classes in the **DocumentFormat.OpenXML.Spreadsheet** namespace. The following table lists the class names of the classes that correspond to the **workbook**, **sheets**, **sheet**, **worksheet**, and **sheetData** elements. -| SpreadsheetML Element | Open XML SDK 2.5 Class | Description | +| SpreadsheetML Element | Open XML SDK Class | Description | |---|---|---| | workbook | DocumentFormat.OpenXml.Spreadsheet.Workbook | The root element for the main document part. | | sheets | DocumentFormat.OpenXml.Spreadsheet.Sheets | The container for the block level structures such as sheet, fileVersion, and others specified in the [ISO/IEC 29500](https://www.iso.org/standard/71691.html) specification. | @@ -112,7 +112,7 @@ After you have opened the file for read-only access, you instantiate the **Sheet Dim sheets As S = mySpreadsheet.WorkbookPart.Workbook.Sheets ``` -You then you iterate through the **Sheets** collection and display **[OpenXmlElement](/dotnet/api/documentformat.openxml.openxmlelement?view=openxml-2.8.1&preserve-view=true)** and the **[OpenXmlAttribute](/api/documentformat.openxml.openxmlattribute?view=openxml-2.8.1&preserve-view=true)** in each element. +You then you iterate through the **Sheets** collection and display **[OpenXmlElement](/dotnet/api/documentformat.openxml.openxmlelement)** and the **[OpenXmlAttribute](/dotnet/api/documentformat.openxml.openxmlattribute)** in each element. ```csharp foreach (E sheet in sheets) @@ -186,4 +186,4 @@ The following is the complete code sample in both C\# and Visual Basic. ## See also -[Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +[Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-insert-a-chart-into-a-spreadsheet.md b/docs/how-to-insert-a-chart-into-a-spreadsheet.md index 4e679ff6..8144172b 100644 --- a/docs/how-to-insert-a-chart-into-a-spreadsheet.md +++ b/docs/how-to-insert-a-chart-into-a-spreadsheet.md @@ -15,7 +15,7 @@ ms.localizationpriority: high # Insert a chart into a spreadsheet document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for Office to insert a chart into a spreadsheet document programmatically. +This topic shows how to use the classes in the Open XML SDK for Office to insert a chart into a spreadsheet document programmatically. The following assembly directives are required to compile the code in this topic. @@ -125,13 +125,13 @@ example. ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content that uses strongly-typed classes that correspond to **SpreadsheetML** elements. You can find these classes in the **DocumentFormat.OpenXml.Spreadsheet** namespace. The following table lists the class names of the classes that correspond to the **workbook**, [Sheets](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.sheets.aspx), [Sheet](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.sheet.aspx), **worksheet**, and [SheetData<](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.sheetdata.aspx) elements. -| **SpreadsheetML Element** | **Open XML SDK 2.5 Class** | **Description** | +| **SpreadsheetML Element** | **Open XML SDK Class** | **Description** | |:---|:---|:---| | workbook | DocumentFormat.OpenXml.Spreadsheet.Workbook | The root element for the main document part. | | sheets | DocumentFormat.OpenXml.Spreadsheet.Sheets | The container for the block level structures such as sheet, fileVersion, and others specified in the [ISO/IEC 29500](https://www.iso.org/standard/71691.html) specification. | @@ -861,7 +861,7 @@ The following is the complete sample code in both C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) [Language-Integrated Query (LINQ)](https://msdn.microsoft.com/library/bb397926.aspx) [Lambda Expressions](https://msdn.microsoft.com/library/bb531253.aspx) [Lambda Expressions (C\# Programming Guide)](https://msdn.microsoft.com/library/bb397687.aspx) diff --git a/docs/how-to-insert-a-comment-into-a-word-processing-document.md b/docs/how-to-insert-a-comment-into-a-word-processing-document.md index 0a28eccc..975b9fe0 100644 --- a/docs/how-to-insert-a-comment-into-a-word-processing-document.md +++ b/docs/how-to-insert-a-comment-into-a-word-processing-document.md @@ -16,7 +16,7 @@ ms.localizationpriority: medium --- # Insert a comment into a word processing document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to programmatically add a comment to the first paragraph in a word processing document. @@ -364,7 +364,7 @@ Following is the complete sample code in both C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) [Language-Integrated Query (LINQ)](https://msdn.microsoft.com/library/bb397926.aspx) diff --git a/docs/how-to-insert-a-new-slide-into-a-presentation.md b/docs/how-to-insert-a-new-slide-into-a-presentation.md index 940848af..706130dc 100644 --- a/docs/how-to-insert-a-new-slide-into-a-presentation.md +++ b/docs/how-to-insert-a-new-slide-into-a-presentation.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Insert a new slide into a presentation (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 to +This topic shows how to use the classes in the Open XML SDK to insert a new slide into a presentation programmatically. The following assembly directives are required to compile the code in @@ -137,13 +137,13 @@ two slides denoted by the Id's 267 and 256. ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content using strongly-typed classes that correspond to PresentationML elements. You can find these classes in the [DocumentFormat.OpenXml.Presentation](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.aspx) namespace. The following table lists the class names of the classes that correspond to the **sld**, **sldLayout**, **sldMaster**, and **notesMaster** elements: -| PresentationML Element | Open XML SDK 2.5 Class | Description | +| PresentationML Element | Open XML SDK Class | Description | |---|---|---| | sld | [Slide](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slide.aspx) | Presentation Slide. It is the root element of SlidePart. | | sldLayout | [SlideLayout](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slidelayout.aspx) | Slide Layout. It is the root element of SlideLayoutPart. | @@ -751,4 +751,4 @@ The following is the complete sample code in both C\# and Visual Basic. -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-insert-a-new-worksheet-into-a-spreadsheet.md b/docs/how-to-insert-a-new-worksheet-into-a-spreadsheet.md index 8b910c94..3ca929a3 100644 --- a/docs/how-to-insert-a-new-worksheet-into-a-spreadsheet.md +++ b/docs/how-to-insert-a-new-worksheet-into-a-spreadsheet.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Insert a new worksheet into a spreadsheet document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to insert a new worksheet into a spreadsheet document programmatically. @@ -119,13 +119,13 @@ code example. ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content that uses strongly-typed classes that correspond to **SpreadsheetML** elements. You can find these classes in the **DocumentFormat.OpenXML.Spreadsheet** namespace. The following table lists the class names of the classes that correspond to the **workbook**, **sheets**, **sheet**, **worksheet**, and **sheetData** elements. -| SpreadsheetML Element | Open XML SDK 2.5 Class | Description | +| SpreadsheetML Element | Open XML SDK Class | Description | |---|---|---| | workbook | DocumentFormat.OpenXml.Spreadsheet.Workbook | The root element for the main document part. | | sheets | DocumentFormat.OpenXml.Spreadsheet.Sheets | The container for the block level structures such as sheet, fileVersion, and others specified in the [ISO/IEC 29500](https://www.iso.org/standard/71691.html) specification. | @@ -296,7 +296,7 @@ Following is the complete sample code in both C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) [Language-Integrated Query (LINQ)](https://msdn.microsoft.com/library/bb397926.aspx) diff --git a/docs/how-to-insert-a-picture-into-a-word-processing-document.md b/docs/how-to-insert-a-picture-into-a-word-processing-document.md index c93a47f3..e429cf17 100644 --- a/docs/how-to-insert-a-picture-into-a-word-processing-document.md +++ b/docs/how-to-insert-a-picture-into-a-word-processing-document.md @@ -17,7 +17,7 @@ ms.localizationpriority: high --- # Insert a picture into a word processing document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for Office to programmatically add a picture to a word processing document. +This topic shows how to use the classes in the Open XML SDK for Office to programmatically add a picture to a word processing document. The following assembly directives are required to compile the code in this topic. @@ -411,4 +411,4 @@ The following is the complete sample code in both C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-insert-a-table-into-a-word-processing-document.md b/docs/how-to-insert-a-table-into-a-word-processing-document.md index ecf19f2a..7d2bcc87 100644 --- a/docs/how-to-insert-a-table-into-a-word-processing-document.md +++ b/docs/how-to-insert-a-table-into-a-word-processing-document.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Insert a table into a word processing document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to programmatically insert a table into a word processing document. @@ -399,7 +399,7 @@ Following is the complete sample code in both C\# and Visual Basic. -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) [Object Initializers: Named and Anonymous Types (Visual Basic .NET)](https://msdn.microsoft.com/library/bb385125.aspx) diff --git a/docs/how-to-insert-text-into-a-cell-in-a-spreadsheet.md b/docs/how-to-insert-text-into-a-cell-in-a-spreadsheet.md index 565abaa9..4298a1ca 100644 --- a/docs/how-to-insert-text-into-a-cell-in-a-spreadsheet.md +++ b/docs/how-to-insert-text-into-a-cell-in-a-spreadsheet.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Insert text into a cell in a spreadsheet document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to insert text into a cell in a new worksheet in a spreadsheet document programmatically. @@ -120,13 +120,13 @@ Sheet1.xml file and is shown in the following code example. ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content that uses strongly-typed classes that correspond to **SpreadsheetML** elements. You can find these classes in the **DocumentFormat.OpenXML.Spreadsheet** namespace. The following table lists the class names of the classes that correspond to the **workbook**, **sheets**, **sheet**, **worksheet**, and **sheetData** elements. -| SpreadsheetML Element | Open XML SDK 2.5 Class | Description | +| SpreadsheetML Element | Open XML SDK Class | Description | |---|---|---| | workbook | DocumentFormat.OpenXml.Spreadsheet.Workbook | The root element for the main document part. | | sheets | DocumentFormat.OpenXml.Spreadsheet.Sheets | The container for the block level structures such as sheet, fileVersion, and others specified in the [ISO/IEC 29500](https://www.iso.org/standard/71691.html) specification. | @@ -762,7 +762,7 @@ The following is the complete sample code in both C\# and Visual Basic. ## See also -[Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +[Open XML SDK class library reference](/office/open-xml/open-xml-sdk) [Language-Integrated Query (LINQ)](https://msdn.microsoft.com/library/bb397926.aspx) diff --git a/docs/how-to-merge-two-adjacent-cells-in-a-spreadsheet.md b/docs/how-to-merge-two-adjacent-cells-in-a-spreadsheet.md index 7d5a087c..a91a2ca0 100644 --- a/docs/how-to-merge-two-adjacent-cells-in-a-spreadsheet.md +++ b/docs/how-to-merge-two-adjacent-cells-in-a-spreadsheet.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Merge two adjacent cells in a spreadsheet document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to merge two adjacent cells in a spreadsheet document programmatically. @@ -129,13 +129,13 @@ Sheet1.xml file and is shown in the following code example. ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content that uses strongly-typed classes that correspond to **SpreadsheetML** elements. You can find these classes in the **DocumentFormat.OpenXML.Spreadsheet** namespace. The following table lists the class names of the classes that correspond to the **workbook**, **sheets**, **sheet**, **worksheet**, and **sheetData** elements. -| SpreadsheetML Element | Open XML SDK 2.5 Class | Description | +| SpreadsheetML Element | Open XML SDK Class | Description | |---|---|---| | workbook | DocumentFormat.OpenXML.Spreadsheet.Workbook | The root element for the main document part. | | sheets | DocumentFormat. OpenXML.Spreadsheet.Sheets | The container for the block level structures such as sheet, fileVersion, and others specified in the [ISO/IEC 29500](https://www.iso.org/standard/71691.html) specification. | @@ -580,7 +580,7 @@ The following is the complete sample code in both C\# and Visual Basic. -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) [Language-Integrated Query (LINQ)](https://msdn.microsoft.com/library/bb397926.aspx) diff --git a/docs/how-to-move-a-paragraph-from-one-presentation-to-another.md b/docs/how-to-move-a-paragraph-from-one-presentation-to-another.md index 1e76b88b..d66c9b5a 100644 --- a/docs/how-to-move-a-paragraph-from-one-presentation-to-another.md +++ b/docs/how-to-move-a-paragraph-from-one-presentation-to-another.md @@ -16,7 +16,7 @@ ms.localizationpriority: medium --- # Move a paragraph from one presentation to another (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to move a paragraph from one presentation to another presentation programmatically. @@ -137,13 +137,13 @@ two slides denoted by the ID 267 and 256. ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content using strongly-typed classes that correspond to PresentationML elements. You can find these classes in the [DocumentFormat.OpenXml.Presentation](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.aspx) namespace. The following table lists the class names of the classes that correspond to the **sld**, **sldLayout**, **sldMaster**, and **notesMaster** elements. -| PresentationML Element | Open XML SDK 2.5 Class | Description | +| PresentationML Element | Open XML SDK Class | Description | |---|---|---| | sld | [Slide](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slide.aspx) | Presentation Slide. It is the root element of SlidePart. | | sldLayout | [SlideLayout](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slidelayout.aspx) | Slide Layout. It is the root element of SlideLayoutPart. | @@ -479,4 +479,4 @@ The following is the complete sample code in both C\# and Visual Basic. -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-move-a-slide-to-a-new-position-in-a-presentation.md b/docs/how-to-move-a-slide-to-a-new-position-in-a-presentation.md index beddf820..3797ae4f 100644 --- a/docs/how-to-move-a-slide-to-a-new-position-in-a-presentation.md +++ b/docs/how-to-move-a-slide-to-a-new-position-in-a-presentation.md @@ -16,7 +16,7 @@ ms.localizationpriority: medium --- # Move a slide to a new position in a presentation (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to move a slide to a new position in a presentation programmatically. @@ -144,13 +144,13 @@ two slides denoted by the ID 267 and 256. ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content using strongly-typed classes that correspond to PresentationML elements. You can find these classes in the [DocumentFormat.OpenXml.Presentation](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.aspx) namespace. The following table lists the class names of the classes that correspond to the **sld**, **sldLayout**, **sldMaster**, and **notesMaster** elements. -| PresentationML Element | Open XML SDK 2.5 Class | Description | +| PresentationML Element | Open XML SDK Class | Description | |---|---|---| | sld | [Slide](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slide.aspx) | Presentation Slide. It is the root element of SlidePart. | | sldLayout | [SlideLayout](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slidelayout.aspx) | Slide Layout. It is the root element of SlideLayoutPart. | @@ -637,4 +637,4 @@ Following is the complete sample code in both C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-open-a-presentation-document-for-read-only-access.md b/docs/how-to-open-a-presentation-document-for-read-only-access.md index dd2038ea..b8e9ee60 100644 --- a/docs/how-to-open-a-presentation-document-for-read-only-access.md +++ b/docs/how-to-open-a-presentation-document-for-read-only-access.md @@ -16,7 +16,7 @@ ms.localizationpriority: medium --- # Open a presentation document for read-only access (Open XML SDK) -This topic describes how to use the classes in the Open XML SDK 2.5 for +This topic describes how to use the classes in the Open XML SDK for Office to programmatically open a presentation document for read-only access. @@ -101,7 +101,7 @@ You can also use the second overload of the **Open** method, in the table above, instance of the **PresentationDocument** class based on an I/O stream. You might use this approach if you have a Microsoft SharePoint Foundation 2010 application that uses stream I/O -and you want to use the Open XML SDK 2.5 to work with a document. The +and you want to use the Open XML SDK to work with a document. The following code segment opens a document based on a stream. ```csharp @@ -122,8 +122,8 @@ following code segment opens a document based on a stream. Suppose you have an application that employs the Open XML support in the **System.IO.Packaging** namespace of the .NET -Framework Class Library, and you want to use the Open XML SDK 2.5 to -work with a package read-only. The Open XML SDK 2.5 includes a method +Framework Class Library, and you want to use the Open XML SDK to +work with a package read-only. The Open XML SDK includes a method overload that accepts a **Package** as the only parameter. There is no Boolean parameter to indicate whether the document should be opened for editing. The recommended approach is to @@ -379,4 +379,4 @@ The following is the complete code listing in C\# and Visual Basic. -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-open-a-spreadsheet-document-for-read-only-access.md b/docs/how-to-open-a-spreadsheet-document-for-read-only-access.md index a8a2a9ff..3afe7e62 100644 --- a/docs/how-to-open-a-spreadsheet-document-for-read-only-access.md +++ b/docs/how-to-open-a-spreadsheet-document-for-read-only-access.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Open a spreadsheet document for read-only access (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to open a spreadsheet document for read-only access programmatically. @@ -99,7 +99,7 @@ The other two **Open** methods create an instance of the SpreadsheetDocument class based on an input/output stream. You might use this approach, for example, if you have a Microsoft SharePoint Foundation 2010 application that uses stream -input/output, and you want to use the Open XML SDK 2.5 to work with a +input/output, and you want to use the Open XML SDK to work with a document. The following code example opens a document based on a stream. @@ -119,8 +119,8 @@ The following code example opens a document based on a stream. Suppose you have an application that uses the Open XML support in the System.IO.Packaging namespace of the .NET Framework Class Library, and -you want to use the Open XML SDK 2.5 to work with a package as -read-only. Whereas the Open XML SDK 2.5 includes method overloads that +you want to use the Open XML SDK to work with a package as +read-only. Whereas the Open XML SDK includes method overloads that accept a **Package** as the first parameter, there is not one that takes a Boolean as the second parameter to indicate whether the document should be opened for editing. @@ -200,13 +200,13 @@ Sheet1.xml file and is as follows. ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content that uses strongly-typed classes that correspond to SpreadsheetML elements. You can find these classes in the **DocumentFormat.OpenXML.Spreadsheet** namespace. The following table lists the class names of the classes that correspond to the **workbook**, **sheets**, **sheet**, **worksheet**, and **sheetData** elements. -SpreadsheetML Element|Open XML SDK 2.5 Class|Description +SpreadsheetML Element|Open XML SDK Class|Description --|--|-- workbook|DocumentFormat.OpenXml.Spreadsheet.Workbook|The root element for the main document part. sheets|DocumentFormat.OpenXml.Spreadsheet.Sheets|The container for the block level structures such as sheet, fileVersion, and others specified in the [ISO/IEC 29500](https://www.iso.org/standard/71691.html) specification. @@ -302,4 +302,4 @@ The following is the complete sample code in both C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-open-a-spreadsheet-document-from-a-stream.md b/docs/how-to-open-a-spreadsheet-document-from-a-stream.md index 7fa3dea6..62fc4c58 100644 --- a/docs/how-to-open-a-spreadsheet-document-from-a-stream.md +++ b/docs/how-to-open-a-spreadsheet-document-from-a-stream.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Open a spreadsheet document from a stream (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to open a spreadsheet document from a stream programmatically. The following assembly directives are required to compile the code in @@ -40,14 +40,14 @@ this topic. ## When to Open From a Stream If you have an application, such as Microsoft SharePoint Foundation 2010, that works with documents by using stream input/output, and you -want to use the Open XML SDK 2.5 to work with one of the documents, this +want to use the Open XML SDK to work with one of the documents, this is designed to be easy to do. This is especially true if the document -exists and you can open it using the Open XML SDK 2.5. However, suppose +exists and you can open it using the Open XML SDK. However, suppose that the document is an open stream at the point in your code where you must use the SDK to work with it? That is the scenario for this topic. The sample method in the sample code accepts an open stream as a parameter and then adds text to the document behind the stream using the -Open XML SDK 2.5. +Open XML SDK. -------------------------------------------------------------------------------- @@ -135,13 +135,13 @@ code example. ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content that uses strongly-typed classes that correspond to SpreadsheetML elements. You can find these classes in the **DocumentFormat.OpenXML.Spreadsheet** namespace. The following table lists the class names of the classes that correspond to the **workbook**, **sheets**, **sheet**, **worksheet**, and **sheetData** elements. -SpreadsheetML Element|Open XML SDK 2.5 Class|Description +SpreadsheetML Element|Open XML SDK Class|Description --|--|-- workbook|DocumentFormat.OpenXml.Spreadsheet.Workbook|The root element for the main document part. sheets|DocumentFormat.OpenXml.Spreadsheet.Sheets|The container for the block level structures such as sheet, fileVersion, and others specified in the [ISO/IEC 29500](https://www.iso.org/standard/71691.html) specification. @@ -280,4 +280,4 @@ The following is the complete sample code in both C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-open-a-word-processing-document-for-read-only-access.md b/docs/how-to-open-a-word-processing-document-for-read-only-access.md index a5dc6812..ea26026e 100644 --- a/docs/how-to-open-a-word-processing-document-for-read-only-access.md +++ b/docs/how-to-open-a-word-processing-document-for-read-only-access.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Open a word processing document for read-only access (Open XML SDK) -This topic describes how to use the classes in the Open XML SDK 2.5 for +This topic describes how to use the classes in the Open XML SDK for Office to programmatically open a word processing document for read only access. @@ -105,7 +105,7 @@ instance of the **WordprocessingDocument** class based on an input/output stream. You might employ this approach, for instance, if you have a Microsoft SharePoint Foundation 2010 application that uses stream input/output, and you want to use the Open -XML SDK 2.5 to work with a document. +XML SDK to work with a document. The following code example opens a document based on a stream. @@ -124,8 +124,8 @@ The following code example opens a document based on a stream. Suppose you have an application that employs the Open XML support in the System.IO.Packaging namespace of the .NET Framework Class Library, and -you want to use the Open XML SDK 2.5 to work with a package read only. -While the Open XML SDK 2.5 includes method overloads that accept a **Package** as the first parameter, there is not one +you want to use the Open XML SDK to work with a package read only. +While the Open XML SDK includes method overloads that accept a **Package** as the first parameter, there is not one that takes a Boolean as the second parameter to indicate whether the document should be opened for editing. @@ -190,13 +190,13 @@ shown in the following code example. ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content using strongly-typed classes that correspond to WordprocessingML elements. You will find these classes in the [DocumentFormat.OpenXml.Wordprocessing](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.aspx) namespace. The following table lists the class names of the classes that correspond to the **document**, **body**, **p**, **r**, and **t** elements. -WordprocessingML Element|Open XML SDK 2.5 Class|Description +WordprocessingML Element|Open XML SDK Class|Description --|--|-- document|[Document](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.document.aspx) |The root element for the main document part. body|[Body](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.body.aspx) |The container for the block level structures such as paragraphs, tables, annotations, and others specified in the [ISO/IEC 29500](https://www.iso.org/standard/71691.html) specification. @@ -359,4 +359,4 @@ The following is the complete sample code in C\# and VB. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-open-a-word-processing-document-from-a-stream.md b/docs/how-to-open-a-word-processing-document-from-a-stream.md index 982989c8..7e09980f 100644 --- a/docs/how-to-open-a-word-processing-document-from-a-stream.md +++ b/docs/how-to-open-a-word-processing-document-from-a-stream.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Open a word processing document from a stream (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to programmatically open a Word processing document from a stream. @@ -39,13 +39,13 @@ this topic. If you have an application, such as a SharePoint application, that works with documents using stream input/output, and you want to employ the -Open XML SDK 2.5 to work with one of the documents, this is designed to +Open XML SDK to work with one of the documents, this is designed to be easy to do. This is particularly true if the document exists and you -can open it using the Open XML SDK 2.5. However, suppose the document is +can open it using the Open XML SDK. However, suppose the document is an open stream at the point in your code where you need to employ the SDK to work with it? That is the scenario for this topic. The sample method in the sample code accepts an open stream as a parameter and then -adds text to the document behind the stream using the Open XML SDK 2.5. +adds text to the document behind the stream using the Open XML SDK. ## Creating a WordprocessingDocument Object @@ -106,13 +106,13 @@ the WordprocessingML markup for a document that contains only the text ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content using strongly-typed classes that correspond to WordprocessingML elements. You can find these classes in the [DocumentFormat.OpenXml.Wordprocessing](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.aspx) namespace. The following table lists the class names of the classes that correspond to the **document**, **body**, **p**, **r**, and **t** elements. -| WordprocessingML Element | Open XML SDK 2.5 Class | Description | +| WordprocessingML Element | Open XML SDK Class | Description | |---|---|---| | document | [Document](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.document.aspx) | The root element for the main document part. | | body |Body |The container for the block-level structures such as paragraphs, tables, annotations, and others specified in the [ISO/IEC 29500](https://www.iso.org/standard/71691.html) specification. | @@ -233,4 +233,4 @@ Following is the complete sample code in both C\# and Visual Basic. -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-open-and-add-text-to-a-word-processing-document.md b/docs/how-to-open-and-add-text-to-a-word-processing-document.md index 3904d109..87015208 100644 --- a/docs/how-to-open-and-add-text-to-a-word-processing-document.md +++ b/docs/how-to-open-and-add-text-to-a-word-processing-document.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Open and add text to a word processing document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to programmatically open and add text to a Word processing document. @@ -35,9 +35,9 @@ this topic. -------------------------------------------------------------------------------- ## How to Open and Add Text to a Document -The Open XML SDK 2.5 helps you create Word processing document structure +The Open XML SDK helps you create Word processing document structure and content using strongly-typed classes that correspond to **WordprocessingML** elements. This topic shows how -to use the classes in the Open XML SDK 2.5 to open a Word processing +to use the classes in the Open XML SDK to open a Word processing document and add text to it. In addition, this topic introduces the basic document structure of a **WordprocessingML** document, the associated XML elements, and their corresponding Open XML SDK classes. @@ -114,13 +114,13 @@ text." ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content using strongly-typed classes that correspond to WordprocessingML elements. You will find these classes in the [DocumentFormat.OpenXml.Wordprocessing](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.aspx) namespace. The following table lists the class names of the classes that correspond to the **document**, **body**, **p**, **r**, and **t** elements. -| WordprocessingML Element | Open XML SDK 2.5 Class | Description | +| WordprocessingML Element | Open XML SDK Class | Description | |---|---|---| | document | [Document](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.document.aspx) | The root element for the main document part. | | body | [Body](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.body.aspx) | The container for the block level structures such as paragraphs, tables, annotations, and others specified in the [ISO/IEC 29500](https://www.iso.org/standard/71691.html) specification. | @@ -222,4 +222,4 @@ of **OpenSettings**. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-parse-and-read-a-large-spreadsheet.md b/docs/how-to-parse-and-read-a-large-spreadsheet.md index 8c8ddc39..d060b582 100644 --- a/docs/how-to-parse-and-read-a-large-spreadsheet.md +++ b/docs/how-to-parse-and-read-a-large-spreadsheet.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Parse and read a large spreadsheet document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to programmatically read a large Excel file. For more information about the basic structure of a **SpreadsheetML** document, see [Structure of a SpreadsheetML document (Open XML SDK)](structure-of-a-spreadsheetml-document.md). @@ -282,4 +282,4 @@ The following is the complete code sample in both C\# and Visual Basic. -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-remove-a-document-part-from-a-package.md b/docs/how-to-remove-a-document-part-from-a-package.md index 41b6f6cb..ed3c3d09 100644 --- a/docs/how-to-remove-a-document-part-from-a-package.md +++ b/docs/how-to-remove-a-document-part-from-a-package.md @@ -16,7 +16,7 @@ ms.localizationpriority: medium --- # Remove a document part from a package (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to remove a document part (file) from a Wordprocessing document programmatically. @@ -105,13 +105,13 @@ sample code creates is shown in the following code example. ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content using strongly-typed classes that correspond to **WordprocessingML** elements. You can find these classes in the [DocumentFormat.OpenXml.Wordprocessing](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.aspx) namespace. The following table lists the class names of the classes that correspond to the **document**, **body**, **p**, **r**, and **t** elements. -WordprocessingML Element|Open XML SDK 2.5 Class|Description +WordprocessingML Element|Open XML SDK Class|Description --|--|-- document|[Document](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.document.aspx) |The root element for the main document part. body|[Body](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.body.aspx) |The container for the block level structures such as paragraphs, tables, annotations, and others specified in the [ISO/IEC 29500](https://www.iso.org/standard/71691.html) specification. @@ -187,7 +187,7 @@ this example. RemovePart(document) ``` > [!NOTE] -> Before running the program on the test file, "MyPkg6.docs," for example, open the file by using the Open XML SDK 2.5 Productivity Tool for Microsoft Office and examine its structure. After running the program, examine the file again, and you will notice that the **DocumentSettingsPart** part was removed. +> Before running the program on the test file, "MyPkg6.docs," for example, open the file by using the Open XML SDK Productivity Tool for Microsoft Office and examine its structure. After running the program, examine the file again, and you will notice that the **DocumentSettingsPart** part was removed. Following is the complete code example in both C\# and Visual Basic. @@ -221,4 +221,4 @@ Following is the complete code example in both C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-remove-hidden-text-from-a-word-processing-document.md b/docs/how-to-remove-hidden-text-from-a-word-processing-document.md index ec4ea0cc..736872e7 100644 --- a/docs/how-to-remove-hidden-text-from-a-word-processing-document.md +++ b/docs/how-to-remove-hidden-text-from-a-word-processing-document.md @@ -16,7 +16,7 @@ ms.localizationpriority: medium --- # Remove hidden text from a word processing document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to programmatically remove hidden text from a word processing document. @@ -94,13 +94,13 @@ markup for a document that contains the text "Example text." ``` -Using the Open XML SDK 2.5, you can create document structure and +Using the Open XML SDK, you can create document structure and content using strongly-typed classes that correspond to **WordprocessingML** elements. You will find these classes in the [DocumentFormat.OpenXml.Wordprocessing](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.aspx) namespace. The following table lists the class names of the classes that correspond to the **document**, **body**, **p**, **r**, and **t** elements. -WordprocessingML Element|Open XML SDK 2.5 Class|Description +WordprocessingML Element|Open XML SDK Class|Description --|--|-- document|[Document](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.document.aspx) |The root element for the main document part. body|[Body](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.body.aspx) |The container for the block level structures such as paragraphs, tables, annotations and others specified in the [ISO/IEC 29500](https://www.iso.org/standard/71691.html) specification. @@ -262,4 +262,4 @@ Following is the complete sample code in both C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-remove-the-headers-and-footers-from-a-word-processing-document.md b/docs/how-to-remove-the-headers-and-footers-from-a-word-processing-document.md index 52d5956c..17979a39 100644 --- a/docs/how-to-remove-the-headers-and-footers-from-a-word-processing-document.md +++ b/docs/how-to-remove-the-headers-and-footers-from-a-word-processing-document.md @@ -17,12 +17,12 @@ ms.localizationpriority: medium --- # Remove the headers and footers from a word processing document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to programmatically remove all headers and footers in a word processing document. It contains an example **RemoveHeadersAndFooters** method to illustrate this task. -To use the sample code in this topic, you must install the [Open XML SDK 2.5](https://www.nuget.org/packages/DocumentFormat.OpenXml/2.5.0). You +To use the sample code in this topic, you must install the [Open XML SDK](https://www.nuget.org/packages/DocumentFormat.OpenXml). You must then explicitly reference the following assemblies in your project. - WindowsBase @@ -148,7 +148,7 @@ Be aware that the **HeaderParts** and **FooterParts** properties each return an Given a collection of references to header and footer parts, you could write code to delete each one individually, but that is not necessary -because of the Open XML SDK 2.5. Instead, you can call the [DeleteParts\](https://msdn.microsoft.com/library/office/cc562335.aspx) method, passing in the +because of the Open XML SDK. Instead, you can call the [DeleteParts\](https://msdn.microsoft.com/library/office/cc562335.aspx) method, passing in the collection of parts to be deleted─this simple method provides a shortcut for deleting a collection of parts. Therefore, the following few lines of code take the place of the loop that you would otherwise have to @@ -203,7 +203,7 @@ loops through the collection, calling the [Remove](https://msdn.microsoft.com/li that the code converts the **IEnumerable** returned by the [Descendants](https://msdn.microsoft.com/library/office/documentformat.openxml.openxmlelement.descendants.aspx) method into a List so that it can delete items from the list, and that the [HeaderReference](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.headerreference.aspx) type that is provided by -the Open XML SDK 2.5 makes it easy to refer to elements of type **HeaderReference** in the XML content. (Without that +the Open XML SDK makes it easy to refer to elements of type **HeaderReference** in the XML content. (Without that additional help, you would have to work with the details of the XML content directly.) Once it has removed all the headers, the code repeats the operation with the footer elements. @@ -366,4 +366,4 @@ Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-replace-the-header-in-a-word-processing-document.md b/docs/how-to-replace-the-header-in-a-word-processing-document.md index cf1551cc..7bb72890 100644 --- a/docs/how-to-replace-the-header-in-a-word-processing-document.md +++ b/docs/how-to-replace-the-header-in-a-word-processing-document.md @@ -17,11 +17,11 @@ ms.localizationpriority: high --- # Replace the header in a word processing document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to replace the header in word processing document programmatically. -To use the sample code in this topic, you must install the [Open XML SDK 2.5](https://www.nuget.org/packages/DocumentFormat.OpenXml/2.5.0). You +To use the sample code in this topic, you must install the [Open XML SDK](https://www.nuget.org/packages/DocumentFormat.OpenXml). You must explicitly reference the following assemblies in your project: - WindowsBase @@ -240,4 +240,4 @@ Following is the complete sample code in both C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference]/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference]/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-replace-the-styles-parts-in-a-word-processing-document.md b/docs/how-to-replace-the-styles-parts-in-a-word-processing-document.md index ec8e5657..179d641e 100644 --- a/docs/how-to-replace-the-styles-parts-in-a-word-processing-document.md +++ b/docs/how-to-replace-the-styles-parts-in-a-word-processing-document.md @@ -17,14 +17,14 @@ ms.localizationpriority: medium --- # Replace the styles parts in a word processing document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to programmatically replace the styles in a word processing document with the styles from another word processing document. It contains an example **ReplaceStyles** method to illustrate this task, as well as the **ReplaceStylesPart** and **ExtractStylesPart** supporting methods. -To use the sample code in this topic, you must install the [Open XML SDK 2.5](https://www.nuget.org/packages/DocumentFormat.OpenXml/2.5.0). You +To use the sample code in this topic, you must install the [Open XML SDK](https://www.nuget.org/packages/DocumentFormat.OpenXml). You must explicitly reference the following assemblies in your project: - WindowsBase @@ -64,7 +64,7 @@ information about the Open Packaging Conventions, see [ISO/IEC 29500-2](https:// Styles are stored in dedicated parts within a word processing document package. An Microsoft Word 2010 document contains a single styles part. Microsoft Word 2013 adds a second stylesWithEffects part. The following -image from the Document Explorer in the Open XML SDK 2.5 Productivity +image from the Document Explorer in the Open XML SDK Productivity Tool for Microsoft Office shows the document parts in a sample Word 2013 document that contains styles. @@ -184,9 +184,7 @@ stylesWithEffects part. ReplaceStylesPart(toDoc, node, True) End If ``` -For more information about the **ExtractStylesPart** method, see [How to: Extract styles from a word processing document -(Open XML SDK)](how-to-extract-styles-from-a-word-processing-document.md). The +For more information about the **ExtractStylesPart** method, see [the associated sample](how-to-extract-styles-from-a-word-processing-document.md). The following section explains the **ReplaceStylesPart** method. --------------------------------------------------------------------------------- @@ -500,4 +498,4 @@ Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-replace-the-theme-part-in-a-word-processing-document.md b/docs/how-to-replace-the-theme-part-in-a-word-processing-document.md index 591bc4a5..89ecb512 100644 --- a/docs/how-to-replace-the-theme-part-in-a-word-processing-document.md +++ b/docs/how-to-replace-the-theme-part-in-a-word-processing-document.md @@ -16,7 +16,7 @@ ms.localizationpriority: medium --- # Replace the theme part in a word processing document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to programmatically replace a document part in a word processing document. @@ -122,7 +122,7 @@ backgrounds, fills, and effects for different objects in a presentation. The following table lists the possible child types of the Theme class. -| PresentationML Element | Open XML SDK 2.5 Class | Description | +| PresentationML Element | Open XML SDK Class | Description | |---|---|---| | custClrLst | [CustomColorList](https://msdn.microsoft.com/library/office/documentformat.openxml.drawing.customcolorlist.aspx) |Custom Color List | | extLst | [ExtensionList](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.extensionlist.aspx) | Extension List | @@ -289,4 +289,4 @@ Following is the complete sample code in both C\# and Visual Basic. -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-retrieve-a-dictionary-of-all-named-ranges-in-a-spreadsheet.md b/docs/how-to-retrieve-a-dictionary-of-all-named-ranges-in-a-spreadsheet.md index f4ada4ee..9a4287e9 100644 --- a/docs/how-to-retrieve-a-dictionary-of-all-named-ranges-in-a-spreadsheet.md +++ b/docs/how-to-retrieve-a-dictionary-of-all-named-ranges-in-a-spreadsheet.md @@ -17,13 +17,13 @@ ms.localizationpriority: medium --- # Retrieve a dictionary of all named ranges in a spreadsheet document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to programmatically retrieve a dictionary that contains the names and ranges of all defined names in an Microsoft Excel 2010 or Microsoft Excel 2013 workbook. It contains an example **GetDefinedNames** method to illustrate this task. -To use the sample code in this topic, you must install the [Open XML SDK 2.5](https://www.nuget.org/packages/DocumentFormat.OpenXml/2.5.0). You +To use the sample code in this topic, you must install the [Open XML SDK](https://www.nuget.org/packages/DocumentFormat.OpenXml). You must explicitly reference the following assemblies in your project: - WindowsBase @@ -140,7 +140,7 @@ document should be open for read-only access (the final false parameter). Given ## Retrieving the Defined Names Given the workbook part, the next step is simple. The code uses the -**Workbook** property of the workbook part to retrieve a reference to the content of the workbook, and then retrieves the **DefinedNames** collection provided by the Open XML SDK 2.5. This property returns a collection of all of the +**Workbook** property of the workbook part to retrieve a reference to the content of the workbook, and then retrieves the **DefinedNames** collection provided by the Open XML SDK. This property returns a collection of all of the defined names that are contained within the workbook. If the property returns a non-null value, the code then iterates through the collection, retrieving information about each named part and adding the key name) and value (range description) to the dictionary for each defined name. ```csharp @@ -231,4 +231,4 @@ The following is the complete **GetDefinedNames** code sample in C\# and Visual ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-retrieve-a-list-of-the-hidden-rows-or-columns-in-a-spreadsheet.md b/docs/how-to-retrieve-a-list-of-the-hidden-rows-or-columns-in-a-spreadsheet.md index 09f6c687..752e61fb 100644 --- a/docs/how-to-retrieve-a-list-of-the-hidden-rows-or-columns-in-a-spreadsheet.md +++ b/docs/how-to-retrieve-a-list-of-the-hidden-rows-or-columns-in-a-spreadsheet.md @@ -17,10 +17,10 @@ ms.localizationpriority: high --- # Retrieve a list of the hidden rows or columns in a spreadsheet document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for Office to programmatically retrieve a list of hidden rows or columns in a Microsoft Excel 2010 or Microsoft Excel 2013 worksheet, without +This topic shows how to use the classes in the Open XML SDK for Office to programmatically retrieve a list of hidden rows or columns in a Microsoft Excel 2010 or Microsoft Excel 2013 worksheet, without loading the document into Excel. It contains an example **GetHiddenRowsOrCols** method to illustrate this task. -To use the sample code in this topic, you must install the [Open XML SDK 2.5](https://www.nuget.org/packages/DocumentFormat.OpenXml/2.5.0). You must explicitly reference the following assemblies in your project: +To use the sample code in this topic, you must install the [Open XML SDK](https://www.nuget.org/packages/DocumentFormat.OpenXml). You must explicitly reference the following assemblies in your project: - WindowsBase @@ -363,4 +363,4 @@ The following is the complete **GetHiddenRowsOrCols** code sample in C\# and Vis ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-retrieve-a-list-of-the-hidden-worksheets-in-a-spreadsheet.md b/docs/how-to-retrieve-a-list-of-the-hidden-worksheets-in-a-spreadsheet.md index 26c14a80..e289925a 100644 --- a/docs/how-to-retrieve-a-list-of-the-hidden-worksheets-in-a-spreadsheet.md +++ b/docs/how-to-retrieve-a-list-of-the-hidden-worksheets-in-a-spreadsheet.md @@ -16,9 +16,9 @@ ms.localizationpriority: medium # Retrieve a list of the hidden worksheets in a spreadsheet document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for Office to programmatically retrieve a list of hidden worksheets in a Microsoft Excel 2010 or Microsoft Excel 2010 workbook, without loading the document into Excel. It contains an example **GetHiddenSheets** method to illustrate this task. +This topic shows how to use the classes in the Open XML SDK for Office to programmatically retrieve a list of hidden worksheets in a Microsoft Excel 2010 or Microsoft Excel 2010 workbook, without loading the document into Excel. It contains an example **GetHiddenSheets** method to illustrate this task. -To use the sample code in this topic, you must install the [Open XML SDK 2.5](https://www.nuget.org/packages/DocumentFormat.OpenXml/2.5.0). You must explicitly reference the following assemblies in your project: +To use the sample code in this topic, you must install the [Open XML SDK](https://www.nuget.org/packages/DocumentFormat.OpenXml). You must explicitly reference the following assemblies in your project: - WindowsBase - DocumentFormat.OpenXml (installed by the Open XML SDK) @@ -111,7 +111,7 @@ Next, the following code opens the specified workbook by using the **Spreadsheet ## Retrieve the collection of worksheets -The **WorkbookPart** class provides a **Workbook** property, which in turn contains the XML content of the workbook. Although the Open XML SDK 2.5 provides the **Sheets** property, which returns a collection of the **Sheet** parts, all the information that you need is provided by the **Sheet** elements within the **Workbook** XML content. +The **WorkbookPart** class provides a **Workbook** property, which in turn contains the XML content of the workbook. Although the Open XML SDK provides the **Sheets** property, which returns a collection of the **Sheet** parts, all the information that you need is provided by the **Sheet** elements within the **Workbook** XML content. The following code uses the **Descendants** generic method of the **Workbook** object to retrieve a collection of **Sheet** objects that contain information about all the sheet child elements of the workbook's XML content. ```csharp @@ -208,4 +208,4 @@ The following is the complete **GetHiddenSheets** code sample in C\# and Visual ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-retrieve-a-list-of-the-worksheets-in-a-spreadsheet.md b/docs/how-to-retrieve-a-list-of-the-worksheets-in-a-spreadsheet.md index fc6215f3..7f7196d7 100644 --- a/docs/how-to-retrieve-a-list-of-the-worksheets-in-a-spreadsheet.md +++ b/docs/how-to-retrieve-a-list-of-the-worksheets-in-a-spreadsheet.md @@ -17,12 +17,12 @@ ms.localizationpriority: high --- # Retrieve a list of the worksheets in a spreadsheet document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to programmatically retrieve a list of the worksheets in a Microsoft Excel 2010 or Microsoft Excel 2013 workbook, without loading the document into Excel. It contains an example **GetAllWorksheets** method to illustrate this task. -To use the sample code in this topic, you must install the [Open XML SDK 2.5](https://www.nuget.org/packages/DocumentFormat.OpenXml/2.5.0). You +To use the sample code in this topic, you must install the [Open XML SDK](https://www.nuget.org/packages/DocumentFormat.OpenXml). You must explicitly reference the following assemblies in your project: - WindowsBase @@ -239,4 +239,4 @@ Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-retrieve-application-property-values-from-a-word-processing-document.md b/docs/how-to-retrieve-application-property-values-from-a-word-processing-document.md index 9911dad6..4fd73f7a 100644 --- a/docs/how-to-retrieve-application-property-values-from-a-word-processing-document.md +++ b/docs/how-to-retrieve-application-property-values-from-a-word-processing-document.md @@ -18,9 +18,9 @@ ms.localizationpriority: medium # Retrieve application property values from a word processing document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for Office to programmatically retrieve an application property from a Microsoft Word 2013 document, without loading the document into Word. It contains example code to illustrate this task. +This topic shows how to use the classes in the Open XML SDK for Office to programmatically retrieve an application property from a Microsoft Word 2013 document, without loading the document into Word. It contains example code to illustrate this task. -To use the sample code in this topic, you must install the [Open XML SDK 2.5](https://www.nuget.org/packages/DocumentFormat.OpenXml/2.5.0). You must explicitly reference the following assemblies in your project: +To use the sample code in this topic, you must install the [Open XML SDK](https://www.nuget.org/packages/DocumentFormat.OpenXml). You must explicitly reference the following assemblies in your project: - WindowsBase - DocumentFormat.OpenXml (installed by the Open XML SDK) @@ -167,4 +167,4 @@ The following is the complete code sample in C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-retrieve-comments-from-a-word-processing-document.md b/docs/how-to-retrieve-comments-from-a-word-processing-document.md index ab40c50b..8a9b8a99 100644 --- a/docs/how-to-retrieve-comments-from-a-word-processing-document.md +++ b/docs/how-to-retrieve-comments-from-a-word-processing-document.md @@ -16,7 +16,7 @@ ms.localizationpriority: medium --- # Retrieve comments from a word processing document (Open XML SDK) -This topic describes how to use the classes in the Open XML SDK 2.5 for +This topic describes how to use the classes in the Open XML SDK for Office to programmatically retrieve the comments from the main document part in a word processing document. @@ -238,4 +238,4 @@ The following is the complete sample code in both C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-retrieve-the-number-of-slides-in-a-presentation-document.md b/docs/how-to-retrieve-the-number-of-slides-in-a-presentation-document.md index 34bd031a..2453a1d5 100644 --- a/docs/how-to-retrieve-the-number-of-slides-in-a-presentation-document.md +++ b/docs/how-to-retrieve-the-number-of-slides-in-a-presentation-document.md @@ -17,14 +17,14 @@ ms.localizationpriority: medium --- # Retrieve the number of slides in a presentation document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to programmatically retrieve the number of slides in a presentation document, either including hidden slides or not, without loading the document into Microsoft PowerPoint. It contains an example **RetrieveNumberOfSlides** method to illustrate this task. -To use the sample code in this topic, you must install the [Open XML SDK 2.5](https://www.nuget.org/packages/DocumentFormat.OpenXml/2.5.0). You +To use the sample code in this topic, you must install the [Open XML SDK](https://www.nuget.org/packages/DocumentFormat.OpenXml). You must explicitly reference the following assemblies in your project: - WindowsBase @@ -248,4 +248,4 @@ Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-retrieve-the-values-of-cells-in-a-spreadsheet.md b/docs/how-to-retrieve-the-values-of-cells-in-a-spreadsheet.md index 5b721aaf..40c9a043 100644 --- a/docs/how-to-retrieve-the-values-of-cells-in-a-spreadsheet.md +++ b/docs/how-to-retrieve-the-values-of-cells-in-a-spreadsheet.md @@ -16,12 +16,12 @@ ms.localizationpriority: high # Retrieve the values of cells in a spreadsheet document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to programmatically retrieve the values of cells in a spreadsheet document. It contains an example **GetCellValue** method to illustrate this task. -To use the sample code in this topic, you must install the [Open XML SDK 2.5](https://www.nuget.org/packages/DocumentFormat.OpenXml/2.5.0). You +To use the sample code in this topic, you must install the [Open XML SDK](https://www.nuget.org/packages/DocumentFormat.OpenXml). You must explicitly reference the following assemblies in your project: - WindowsBase @@ -540,4 +540,4 @@ The following is the complete **GetCellValue** code sample in C\# and Visual Bas ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-search-and-replace-text-in-a-document-part.md b/docs/how-to-search-and-replace-text-in-a-document-part.md index 6f51f5e6..39216166 100644 --- a/docs/how-to-search-and-replace-text-in-a-document-part.md +++ b/docs/how-to-search-and-replace-text-in-a-document-part.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Search and replace text in a document part (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to programmatically search and replace a text value in a word processing document. @@ -199,6 +199,6 @@ The following is the complete sample code in both C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) [Regular Expressions](https://msdn.microsoft.com/library/hs600312.aspx) diff --git a/docs/how-to-set-a-custom-property-in-a-word-processing-document.md b/docs/how-to-set-a-custom-property-in-a-word-processing-document.md index 0ecc0da7..2f8fcf28 100644 --- a/docs/how-to-set-a-custom-property-in-a-word-processing-document.md +++ b/docs/how-to-set-a-custom-property-in-a-word-processing-document.md @@ -6,7 +6,7 @@ api_type: - schema ms.assetid: how-to-set-a-custom-property-in-a-word-processing-document title: 'How to: Set a custom property in a word processing document (Open XML SDK)' -description: 'Learn how to use the classes in the Open XML SDK 2.5 for Office to programmatically set a custom property in a word processing document.' +description: 'Learn how to use the classes in the Open XML SDK for Office to programmatically set a custom property in a word processing document.' ms.suite: office ms.author: o365devx @@ -17,9 +17,9 @@ ms.localizationpriority: high --- # Set a custom property in a word processing document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for Office to programmatically set a custom property in a word processing document. It contains an example **SetCustomProperty** method to illustrate this task. +This topic shows how to use the classes in the Open XML SDK for Office to programmatically set a custom property in a word processing document. It contains an example **SetCustomProperty** method to illustrate this task. -To use the sample code in this topic, you must install the [Open XML SDK 2.5](https://www.nuget.org/packages/DocumentFormat.OpenXml/2.5.0). You must explicitly reference the following assemblies in your project: +To use the sample code in this topic, you must install the [Open XML SDK](https://www.nuget.org/packages/DocumentFormat.OpenXml). You must explicitly reference the following assemblies in your project: - WindowsBase @@ -80,7 +80,7 @@ contents of the part. Figure 1. Open XML SDK Productivity Tool for Microsoft Office - ![Open XML SDK 2.0 Productivity Tool](./media/OpenXmlCon_HowToSetCustomProperty_Fig1.gif) + ![Open XML SDK Productivity Tool](./media/OpenXmlCon_HowToSetCustomProperty_Fig1.gif) The relevant XML is also extracted and shown here for ease of reading. @@ -728,4 +728,4 @@ The following is the complete **SetCustomProperty** code sample in C\# and Visua ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/how-to-set-the-font-for-a-text-run.md b/docs/how-to-set-the-font-for-a-text-run.md index 438ce739..8079fc0b 100644 --- a/docs/how-to-set-the-font-for-a-text-run.md +++ b/docs/how-to-set-the-font-for-a-text-run.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Set the font for a text run (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to set the font for a portion of text within a word processing document programmatically. @@ -269,7 +269,7 @@ The following is the complete sample code in both C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) [Object Initializers: Named and Anonymous Types](https://msdn.microsoft.com/library/bb385125.aspx) diff --git a/docs/how-to-validate-a-word-processing-document.md b/docs/how-to-validate-a-word-processing-document.md index f060fd5b..0c24ffaa 100644 --- a/docs/how-to-validate-a-word-processing-document.md +++ b/docs/how-to-validate-a-word-processing-document.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Validate a word processing document (Open XML SDK) -This topic shows how to use the classes in the Open XML SDK 2.5 for +This topic shows how to use the classes in the Open XML SDK for Office to programmatically validate a word processing document. The following assembly directives are required to compile the code in @@ -219,4 +219,4 @@ Following is the complete sample code in both C\# and Visual Basic. ## See also -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) diff --git a/docs/introduction-to-markup-compatibility.md b/docs/introduction-to-markup-compatibility.md index 0c527ae8..e9272221 100644 --- a/docs/introduction-to-markup-compatibility.md +++ b/docs/introduction-to-markup-compatibility.md @@ -17,7 +17,7 @@ ms.localizationpriority: high # Introduction to markup compatibility (Open XML SDK) -This topic introduces the markup compatibility features included in the Open XML SDK 2.5 for Office. +This topic introduces the markup compatibility features included in the Open XML SDK for Office. ## Introduction @@ -27,7 +27,7 @@ Consider also what should happen if you open that document in a hypothetical lat Open XML anticipates these scenarios. The Office Open XML File Formats specification describes facilities for achieving the above desired outcomes in [ECMA-376, Second Edition, Part 3 - Markup Compatibility and Extensibility](https://www.ecma-international.org/publications-and-standards/standards/ecma-376/). -The Open XML SDK 2.5 supports markup compatibility in a way that makes it easy for you to achieve the above desired outcomes for and Office 2013 without having to necessarily become an expert in the specification details. +The Open XML SDK supports markup compatibility in a way that makes it easy for you to achieve the above desired outcomes for and Office 2013 without having to necessarily become an expert in the specification details. ## What is markup compatibility? @@ -35,22 +35,22 @@ Open XML defines formats for word-processing, spreadsheet and presentation docum ## Markup compatibility in the Open XML file formats specification -Markup compatibility is discussed in [ECMA-376, Second Edition, Part 3 - Markup Compatibility and Extensibility](https://www.ecma-international.org/publications/files/ECMA-ST/ECMA-376,%20Second%20Edition, 20Part%203%20-%20Markup%20Compatibility%20and%20Extensibility.zip), which is recommended reading to understand markup compatibility. The specification defines XML attributes to express compatibility rules, and XML elements to specify alternate content. For example, the **Ignorable** attribute specifies namespaces that can be ignored when they are not understood by the consuming application. Alternate-Content elements specify markup alternatives that can be chosen by an application at run time. For example, Word 2013 can choose only the markup alternative that it recognizes. The complete list of compatibility-rule attributes and alternate-content elements and their details can be found in the specification. +Markup compatibility is discussed in [ECMA-376, Second Edition, Part 3 - Markup Compatibility and Extensibility](https://www.ecma-international.org/wp-content/uploads/ECMA-376-3_5th_edition_december_2015.zip), which is recommended reading to understand markup compatibility. The specification defines XML attributes to express compatibility rules, and XML elements to specify alternate content. For example, the **Ignorable** attribute specifies namespaces that can be ignored when they are not understood by the consuming application. Alternate-Content elements specify markup alternatives that can be chosen by an application at run time. For example, Word 2013 can choose only the markup alternative that it recognizes. The complete list of compatibility-rule attributes and alternate-content elements and their details can be found in the specification. -## Open XML SDK 2.5 support for markup compatibility +## Open XML SDK support for markup compatibility -The work that the Open XML SDK 2.5 does for markup compatibility is detailed and subtle. However, the goal can be summarized as: using settings that you assign when you open a document, preprocess the document to: +The work that the Open XML SDK does for markup compatibility is detailed and subtle. However, the goal can be summarized as: using settings that you assign when you open a document, preprocess the document to: 1. Filter or remove any elements from namespaces that will not be understood (for example, Office 2013 document opened in Office 2010 context) 2. Process any markup compatibility elements and attributes as specified in the Open XML specification. The preprocessing performed is in accordance with ECMA-376, Second Edition: Part 3.13. -The Open XML SDK 2.5 support for markup compatibility comes primarily in the form of two classes and in the manner in which content is preprocessed in accordance with ECMA-376, Second Edition. The two classes are **OpenSettings** and **MarkupCompatibilityProcessSettings**. Use the former to provide settings that apply to SDK behavior overall. Use the latter to supply one part of those settings, specifically those that apply to markup compatibility. +The Open XML SDK support for markup compatibility comes primarily in the form of two classes and in the manner in which content is preprocessed in accordance with ECMA-376, Second Edition. The two classes are **OpenSettings** and **MarkupCompatibilityProcessSettings**. Use the former to provide settings that apply to SDK behavior overall. Use the latter to supply one part of those settings, specifically those that apply to markup compatibility. ## Set the stage when you open -When you open a document using the Open XML SDK 2.5, you have the option of using an overload with a signature that accepts an instance of the **[OpenSettings](https://msdn.microsoft.com/library/office/documentformat.openxml.packaging.opensettings.aspx)** class as a parameter. You use the open settings class to provide certain important settings that govern the behavior of the SDK. One set of settings in particular, stored in the **[MarkupCompatibilityProcessSettings](https://msdn.microsoft.com/library/office/documentformat.openxml.packaging.opensettings.markupcompatibilityprocesssettings.aspx)** property, determines how markup compatibility elements and attributes are processed. You set the property to an instance of the **[MarkupCompatibilityProcessSettings](https://msdn.microsoft.com/library/office/documentformat.openxml.packaging.markupcompatibilityprocesssettings.aspx)** class prior to opening a document. +When you open a document using the Open XML SDK, you have the option of using an overload with a signature that accepts an instance of the **[OpenSettings](https://msdn.microsoft.com/library/office/documentformat.openxml.packaging.opensettings.aspx)** class as a parameter. You use the open settings class to provide certain important settings that govern the behavior of the SDK. One set of settings in particular, stored in the **[MarkupCompatibilityProcessSettings](https://msdn.microsoft.com/library/office/documentformat.openxml.packaging.opensettings.markupcompatibilityprocesssettings.aspx)** property, determines how markup compatibility elements and attributes are processed. You set the property to an instance of the **[MarkupCompatibilityProcessSettings](https://msdn.microsoft.com/library/office/documentformat.openxml.packaging.markupcompatibilityprocesssettings.aspx)** class prior to opening a document. The class has the following properties: @@ -84,7 +84,7 @@ The following code example demonstrates how to call the Open method with an inst ## What happens during preprocessing -During preprocessing, the Open XML SDK 2.5 removes elements and attributes in the markup compatibility namespace, removing the contents of unselected alternate-content elements, and interpreting compatibility-rule attributes as appropriate. This work is guided by the process mode and target file format versions properties. +During preprocessing, the Open XML SDK removes elements and attributes in the markup compatibility namespace, removing the contents of unselected alternate-content elements, and interpreting compatibility-rule attributes as appropriate. This work is guided by the process mode and target file format versions properties. The **ProcessMode** property determines the parts to be preprocessed. The content in *those* parts is filtered to contain only elements that are understood by the application version indicated in the **TargetFileFormatVersions** property. @@ -105,5 +105,5 @@ The target file format versions property lets you choose to process markup compa The default value, **Office2010**, means the SDK will assume that namespaces defined in Office 2010 are understood, but not namespaces defined in Office 2013. Thus, during preprocessing, the SDK will ignore the namespaces defined in Office 2013 and choose the Office 2010 compatible alternate-content. -When you set the target file format versions property to **Office2013**, the Open XML SDK 2.5 assumes that all of the namespaces defined in Office 2010 and Office 2013 are understood, does not ignore any content defined under Office 2013, and will choose +When you set the target file format versions property to **Office2013**, the Open XML SDK assumes that all of the namespaces defined in Office 2010 and Office 2013 are understood, does not ignore any content defined under Office 2013, and will choose the Office 2013 compatible alternate-content. diff --git a/docs/open-xml-sdk-design-considerations.md b/docs/open-xml-sdk-design-considerations.md index 585f9a87..cfc5c1d4 100644 --- a/docs/open-xml-sdk-design-considerations.md +++ b/docs/open-xml-sdk-design-considerations.md @@ -5,7 +5,7 @@ api_name: api_type: - schema ms.assetid: 43c49a6d-96b5-4e87-a5bf-01629d61aad4 -title: Open XML SDK 2.5 for Office design considerations +title: Open XML SDK for Office design considerations ms.suite: office ms.author: o365devx @@ -14,25 +14,25 @@ ms.topic: conceptual ms.date: 11/01/2017 ms.localizationpriority: high --- -# Open XML SDK 2.5 for Office design considerations +# Open XML SDK for Office design considerations -Before using the Open XML SDK 2.5 for Office, be aware of the following +Before using the Open XML SDK for Office, be aware of the following design considerations. -------------------------------------------------------------------------------- ## Design Considerations -The Open XML SDK 2.5: +The Open XML SDK: - Does not replace the Microsoft Office Object Model and provides no abstraction on top of the file formats. You must still understand - the structure of the file formats to use the Open XML SDK 2.5. + the structure of the file formats to use the Open XML SDK. - Does not provide functionality to convert Open XML formats to and from other formats, such as HTML or XPS. - Does not guarantee document validity of Open XML Formats when you - use the Open XML SDK 2.5 or if you decide to manipulate the + use the Open XML SDK or if you decide to manipulate the underlying XML directly. - Does not provide application behavior such as layout functionality diff --git a/docs/open-xml-sdk.md b/docs/open-xml-sdk.md index 1268b4c6..b9141bf0 100644 --- a/docs/open-xml-sdk.md +++ b/docs/open-xml-sdk.md @@ -8,8 +8,8 @@ api_name: api_type: - schema ms.assetid: f6a9ae68-7989-4208-97f5-3c945137a0ab -title: Welcome to the Open XML SDK 2.5 for Office -description: 'Documentation and guidance for the strongly-typed classes in the Open XML SDK 2.5 for Office.' +title: Welcome to the Open XML SDK for Office +description: 'Documentation and guidance for the strongly-typed classes in the Open XML SDK for Office.' ms.suite: office ms.author: o365devx @@ -19,24 +19,24 @@ ms.date: 06/28/2021 ms.localizationpriority: high --- -# Welcome to the Open XML SDK 2.5 for Office +# Welcome to the Open XML SDK for Office This content set provides documentation and guidance for the -strongly-typed classes in the Open XML SDK 2.5 for Office. +strongly-typed classes in the Open XML SDK for Office. The SDK is built on the **System.IO.Packaging** API and provides strongly-typed classes to manipulate documents that adhere to the Office Open XML File Formats specification. The Office Open XML File Formats specification is an open, international, -[ECMA-376, Second Edition](https://www.ecma-international.org/publications/standards/Ecma-376.htm) +[ECMA-376, 5th Edition](https://www.ecma-international.org/publications-and-standards/standards/ecma-376/) and [ISO/IEC 29500](https://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=51463) standard. The Open XML file formats are useful for developers because they are an open standard and are based on well-known technologies: ZIP and XML. -The Open XML SDK 2.5 simplifies the task of manipulating Open XML +The Open XML SDK simplifies the task of manipulating Open XML packages and the underlying Open XML schema elements within a package. -The Open XML SDK 2.5 encapsulates many common tasks that developers +The Open XML SDK encapsulates many common tasks that developers perform on Open XML packages, so that you can perform complex operations with just a few lines of code. @@ -46,14 +46,14 @@ Portions of ISO/IEC 29500:20081 are referenced in the SDK. ## In this section -- [Getting started with the Open XML SDK 2.5 for Office](getting-started.md) +- [Getting started with the Open XML SDK for Office](getting-started.md) - [Understanding the Open XML file formats](understanding-the-open-xml-file-formats.md) - [How do I... (Open XML SDK)](how-do-i.md) -- [Open XML SDK 2.5 class library reference](/office/open-xml/open-xml-sdk) +- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk) ## See also -- [Open XML SDK 2.5 for Microsoft Office](https://www.nuget.org/packages/DocumentFormat.OpenXml/2.5.0) +- [Open XML SDK for Microsoft Office](https://www.nuget.org/packages/DocumentFormat.OpenXml) - [Microsoft Office Developer Center](https://developer.microsoft.com/office/docs) - [Samples on GitHub](https://github.com/OfficeDev) - [Open XML SDK copyright notice](https://msdn.microsoft.com/library/6165f4ad-2e4d-4852-921a-087782af364d(Office.15).aspx) diff --git a/docs/packages-and-general.md b/docs/packages-and-general.md index 33dc1085..a83cfe0b 100644 --- a/docs/packages-and-general.md +++ b/docs/packages-and-general.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Packages and general (Open XML SDK) -This section provides how-to topics for working with documents and packages using the Open XML SDK 2.5. +This section provides how-to topics for working with documents and packages using the Open XML SDK. ## In this section @@ -41,4 +41,4 @@ This section provides how-to topics for working with documents and packages usin ## Related sections - [How do I...](how-do-i.md) -- [Getting started with the Open XML SDK 2.5 for Office](getting-started.md) +- [Getting started with the Open XML SDK for Office](getting-started.md) diff --git a/docs/presentations.md b/docs/presentations.md index 8d8d79de..ae9531f4 100644 --- a/docs/presentations.md +++ b/docs/presentations.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Presentations (Open XML SDK) -This section provides how-to topics for working with presentation documents using the Open XML SDK 2.5. +This section provides how-to topics for working with presentation documents using the Open XML SDK. ## In this section @@ -55,4 +55,4 @@ This section provides how-to topics for working with presentation documents usin ## Related sections - [How do I...](how-do-i.md) -- [Getting started with the Open XML SDK 2.5 for Office](getting-started.md) +- [Getting started with the Open XML SDK for Office](getting-started.md) diff --git a/docs/spreadsheets.md b/docs/spreadsheets.md index 2939828c..11a87a68 100644 --- a/docs/spreadsheets.md +++ b/docs/spreadsheets.md @@ -17,7 +17,7 @@ ms.localizationpriority: high # Spreadsheets (Open XML SDK) -This section provides how-to topics for working with spreadsheet documents using the Open XML SDK 2.5 for Office. +This section provides how-to topics for working with spreadsheet documents using the Open XML SDK for Office. ## In this section @@ -57,4 +57,4 @@ This section provides how-to topics for working with spreadsheet documents using ## Related sections - [How do I...](how-do-i.md) -- [Getting started with the Open XML SDK 2.5 for Office](getting-started.md) +- [Getting started with the Open XML SDK for Office](getting-started.md) diff --git a/docs/structure-of-a-presentationml-document.md b/docs/structure-of-a-presentationml-document.md index b34afe61..180af233 100644 --- a/docs/structure-of-a-presentationml-document.md +++ b/docs/structure-of-a-presentationml-document.md @@ -25,21 +25,21 @@ A PresentationML document is not stored as one large body in a single part. Inst ## Important Presentation Parts -Using the Open XML SDK 2.5, you can create document structure and content that uses strongly-typed classes that correspond to PresentationML elements. You can find these classes in the **[DocumentFormat.OpenXml.Presentation](/dotnet/api/documentformat.openxml.presentation?view=openxml-2.8.1&preserve-view=true)** namespace. The following table lists the class names of the classes that correspond to some of the important presentation elements. +Using the Open XML SDK, you can create document structure and content that uses strongly-typed classes that correspond to PresentationML elements. You can find these classes in the **[DocumentFormat.OpenXml.Presentation](/dotnet/api/documentformat.openxml.presentation)** namespace. The following table lists the class names of the classes that correspond to some of the important presentation elements. -| **Package Part** | **Top Level PresentationML Element** | **Open XML SDK 2.5 Class** | **Description**\* | +| **Package Part** | **Top Level PresentationML Element** | **Open XML SDK Class** | **Description**\* | |-------------------------|--------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| Presentation | \ | [Presentation](/dotnet/api/documentformat.openxml.presentation.presentation?view=openxml-2.8.1&preserve-view=true) | The root element for the Presentation part. This element specifies within it fundamental presentation-wide properties. | -| Presentation Properties | \ | [PresentationProperties](/dotnet/api/documentformat.openxml.presentation.presentationproperties?view=openxml-2.8.1&preserve-view=true) | The root element for the Presentation Properties part. This element functions as a parent element within which additional presentation-wide document properties are contained. | -| Slide Master | \ | [SlideMaster](/dotnet/api/documentformat.openxml.presentation.slidemaster?view=openxml-2.8.1&preserve-view=true) | The root element for the Slide Master part. Within a slide master slide are contained all elements that describe the objects and their corresponding formatting for within a presentation slide. For more information, see [Working with slide masters (Open XML SDK)](working-with-slide-masters.md). | -| Slide Layout | \ | [SlideLayout](/dotnet/api/documentformat.openxml.presentation.slidelayout?view=openxml-2.8.1&preserve-view=true) | The root element for the Slide Layout part. This element specifies the relationship information for each slide layout that is used within the slide master. For more information, see [Working with slide layouts (Open XML SDK)](working-with-slide-layouts.md). | -| Theme | \ | [Theme](/dotnet/api/documentformat.openxml.drawing.theme?view=openxml-2.8.1&preserve-view=true) | The root element for the Theme part. This element holds all the different formatting options available to a document through a theme and defines the overall look and feel of the document when themed objects are used within the document. | -| Slide | \ | [Slide](/dotnet/api/documentformat.openxml.presentation.slide?view=openxml-2.8.1&preserve-view=true) | The root element for the Slide part. This element specifies a slide within a slide list. For more information, see [Working with presentation slides (Open XML SDK)](working-with-presentation-slides.md). | -| Notes Master | \ | [NotesMaster](/dotnet/api/documentformat.openxml.presentation.notesmaster?view=openxml-2.8.1&preserve-view=true) | The root element for the Notes Master part. Within a notes master slide are contained all elements that describe the objects and their corresponding formatting for within a notes slide. | -| Notes Slide | \ | [NotesSlide](/dotnet/api/documentformat.openxml.presentation.notesslide?view=openxml-2.8.1&preserve-view=true) | The root element of the Notes Slide part. This element specifies the existence of a notes slide along with its corresponding data. Contained within a notes slide are all the common slide elements along with addition properties that are specific to the notes element. For more information, see [Working with notes slides (Open XML SDK)](working-with-notes-slides.md). | -| Handout Master | \ | [HandoutMaster](/dotnet/api/documentformat.openxml.presentation.handoutmaster?redirectedfrom=MSDN&view=openxml-2.8.1&preserve-view=true ) | The root element of the Handout Master part. Within a handout master slide are contained all elements that describe the objects and their corresponding formatting for within a handout slide. For more information, see [Working with handout master slides (Open XML SDK)](working-with-handout-master-slides.md). | -| Comments | \ | [CommentList](/dotnet/api/documentformat.openxml.presentation.commentlist?redirectedfrom=MSDN&view=openxml-2.8.1&preserve-view=true ) | The root element of the Comments part. This element specifies a list of comments for a particular slide. For more information, see [Working with comments (Open XML SDK)](working-with-comments.md). | -| Comments Author | \ | [CommentAuthorList](/dotnet/api/documentformat.openxml.presentation.commentauthorlist?redirectedfrom=MSDN&view=openxml-2.8.1&preserve-view=true ) | The root element of the Comments Author part. This element specifies a list of authors with comments in the current document. For more information, see [Working with comments (Open XML SDK)](working-with-comments.md). | +| Presentation | \ | [Presentation](/dotnet/api/documentformat.openxml.presentation.presentation) | The root element for the Presentation part. This element specifies within it fundamental presentation-wide properties. | +| Presentation Properties | \ | [PresentationProperties](/dotnet/api/documentformat.openxml.presentation.presentationproperties) | The root element for the Presentation Properties part. This element functions as a parent element within which additional presentation-wide document properties are contained. | +| Slide Master | \ | [SlideMaster](/dotnet/api/documentformat.openxml.presentation.slidemaster) | The root element for the Slide Master part. Within a slide master slide are contained all elements that describe the objects and their corresponding formatting for within a presentation slide. For more information, see [Working with slide masters (Open XML SDK)](working-with-slide-masters.md). | +| Slide Layout | \ | [SlideLayout](/dotnet/api/documentformat.openxml.presentation.slidelayout) | The root element for the Slide Layout part. This element specifies the relationship information for each slide layout that is used within the slide master. For more information, see [Working with slide layouts (Open XML SDK)](working-with-slide-layouts.md). | +| Theme | \ | [Theme](/dotnet/api/documentformat.openxml.drawing.theme) | The root element for the Theme part. This element holds all the different formatting options available to a document through a theme and defines the overall look and feel of the document when themed objects are used within the document. | +| Slide | \ | [Slide](/dotnet/api/documentformat.openxml.presentation.slide) | The root element for the Slide part. This element specifies a slide within a slide list. For more information, see [Working with presentation slides (Open XML SDK)](working-with-presentation-slides.md). | +| Notes Master | \ | [NotesMaster](/dotnet/api/documentformat.openxml.presentation.notesmaster) | The root element for the Notes Master part. Within a notes master slide are contained all elements that describe the objects and their corresponding formatting for within a notes slide. | +| Notes Slide | \ | [NotesSlide](/dotnet/api/documentformat.openxml.presentation.notesslide) | The root element of the Notes Slide part. This element specifies the existence of a notes slide along with its corresponding data. Contained within a notes slide are all the common slide elements along with addition properties that are specific to the notes element. For more information, see [Working with notes slides (Open XML SDK)](working-with-notes-slides.md). | +| Handout Master | \ | [HandoutMaster](/dotnet/api/documentformat.openxml.presentation.handoutmaster) | The root element of the Handout Master part. Within a handout master slide are contained all elements that describe the objects and their corresponding formatting for within a handout slide. For more information, see [Working with handout master slides (Open XML SDK)](working-with-handout-master-slides.md). | +| Comments | \ | [CommentList](/dotnet/api/documentformat.openxml.presentation.commentlist) | The root element of the Comments part. This element specifies a list of comments for a particular slide. For more information, see [Working with comments (Open XML SDK)](working-with-comments.md). | +| Comments Author | \ | [CommentAuthorList](/dotnet/api/documentformat.openxml.presentation.commentauthorlist) | The root element of the Comments Author part. This element specifies a list of authors with comments in the current document. For more information, see [Working with comments (Open XML SDK)](working-with-comments.md). | *Descriptions adapted from the [ISO/IEC 29500](https://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=51463) specification, © ISO/IEC29500: 2008. @@ -612,7 +612,7 @@ The packaging structure of a presentation document contains several references b ## Generated PresentationML XML Code -After you run the Open XML SDK 2.5 code to generate a presentation, you can explore the contents of the .zip package to view the PresentationML XML code. To view the .zip package, rename the extension on the minimum presentation from **.pptx** to **.zip**. Inside the .zip package, there are several parts that make up the minimum presentation. +After you run the Open XML SDK code to generate a presentation, you can explore the contents of the .zip package to view the PresentationML XML code. To view the .zip package, rename the extension on the minimum presentation from **.pptx** to **.zip**. Inside the .zip package, there are several parts that make up the minimum presentation. Figure 1 shows the structure under the **ppt** folder of the .zip package for a minimum presentation that contains a single slide. @@ -622,7 +622,7 @@ Figure 1. Minimum presentation folder structure The presentation.xml file contains \ (Slide) elements that reference the slides in the presentation. Each slide is associated to the presentation by means of a slide ID and a relationship ID. The **slideID** is the identifier (ID) used within the package to identify a slide and must be unique within the presentation. The **id** attribute is the relationship ID that identifies the slide part definition associated with a slide. For more information about the slide part, see [Working with presentation slides (Open XML SDK)](working-with-presentation-slides.md). -The following XML code is the PresentationML that represents the presentation part of a presentation document that contains a single slide. This code is generated when you run the Open XML SDK 2.5 code to create a minimum presentation. +The following XML code is the PresentationML that represents the presentation part of a presentation document that contains a single slide. This code is generated when you run the Open XML SDK code to create a minimum presentation. ```xml @@ -646,7 +646,7 @@ The following XML code is the PresentationML that represents the presentation pa ``` -The following XML code is the PresentationML that represents the relationship part of the presentation document. This code is generated when you run the Open XML SDK 2.5 to create a minimum presentation. +The following XML code is the PresentationML that represents the relationship part of the presentation document. This code is generated when you run the Open XML SDK to create a minimum presentation. ```xml @@ -663,7 +663,7 @@ The following XML code is the PresentationML that represents the relationship pa ``` -The following XML code is the PresentationML that represents the slide part of the presentation document. Each slide in a presentation has a slide part associated with it. This code is generated when you run the Open XML SDK 2.5 to create a minimum presentation. +The following XML code is the PresentationML that represents the slide part of the presentation document. Each slide in a presentation has a slide part associated with it. This code is generated when you run the Open XML SDK to create a minimum presentation. ```xml diff --git a/docs/structure-of-a-spreadsheetml-document.md b/docs/structure-of-a-spreadsheetml-document.md index 9631b6a5..2cee3bed 100644 --- a/docs/structure-of-a-spreadsheetml-document.md +++ b/docs/structure-of-a-spreadsheetml-document.md @@ -31,14 +31,14 @@ related elements. -------------------------------------------------------------------------------- ## Important Spreadsheet Parts -Using the Open XML SDK 2.5 for Office, you can create document structure +Using the Open XML SDK for Office, you can create document structure and content that uses strongly-typed classes that correspond to **SpreadsheetML** elements. You can find these classes in the **DocumentFormat.OpenXML.Spreadsheet** namespace. The following table lists the class names of the classes that correspond to some of the important spreadsheet elements. -| Package Part| Top Level SpreadsheetML Element | Open XML SDK 2.5 Class | Description| +| Package Part| Top Level SpreadsheetML Element | Open XML SDK Class | Description| |:------------|:--------------------------------|:-----------------------|:-----------| | Workbook | workbook | [Workbook](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.workbook.aspx) | The root element for the main document part.| | Worksheet | worksheet | [Worksheet](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.worksheet.aspx) | A type of sheet that represent a grid of cells that contains text, numbers, dates or formulas. For more information, see [Working with sheets (Open XML SDK)](working-with-sheets.md). | @@ -55,7 +55,7 @@ some of the important spreadsheet elements. -------------------------------------------------------------------------------- ## Minimum Workbook Scenario -The following text from the [Standard ECMA-376](https://www.ecma-international.org/publications/standards/Ecma-376.htm) +The following text from the [Standard ECMA-376](https://www.ecma-international.org/publications-and-standards/standards/ecma-376/) introduces the minimum workbook scenario. The smallest possible (blank) workbook must contain the following: @@ -70,7 +70,7 @@ A relationship Id that points to the location of the sheet definition ### Open XML SDK Code Example -This code example uses the classes in the Open XML SDK 2.5 to create a +This code example uses the classes in the Open XML SDK to create a minimum, blank workbook. ```csharp @@ -136,7 +136,7 @@ minimum, blank workbook. ### Generated SpreadsheetML -After you run the Open XML SDK 2.5 code to generate a minimum workbook, +After you run the Open XML SDK code to generate a minimum workbook, you can explore the contents of the .zip package to view the SpreadsheetML XML code. To view the .zip package, rename the extension on the minimum spreadsheet from **.xlsx** to @@ -160,7 +160,7 @@ with a sheet. The following XML code is the spreadsheetML that represents the workbook part of the spreadsheet document. This code is generated when you run -the Open XML SDK 2.5 code to create a minimum workbook. +the Open XML SDK code to create a minimum workbook. ```xml @@ -177,7 +177,7 @@ relationships between the workbook and the worksheets it contains. The following XML code is the spreadsheetML that represents the relationship part of the spreadsheet document. This code is generated -when you run the Open XML SDK 2.5 to create a minimum workbook. +when you run the Open XML SDK to create a minimum workbook. ```xml @@ -192,7 +192,7 @@ information about sheets, see [Working with sheets (Open XML SDK)](working-with- The following XML code is the spreadsheetML that represents the worksheet part of the spreadsheet document. This code is generated when -you run the Open XML SDK 2.5 to create a minimum workbook. +you run the Open XML SDK to create a minimum workbook. ```xml diff --git a/docs/structure-of-a-wordprocessingml-document.md b/docs/structure-of-a-wordprocessingml-document.md index 76a4b112..7ae849af 100644 --- a/docs/structure-of-a-wordprocessingml-document.md +++ b/docs/structure-of-a-wordprocessingml-document.md @@ -30,15 +30,15 @@ or more \<**t**\> elements. The \<**t**\> element contains a range of text. ## Important WordprocessingML Parts -The Open XML SDK 2.5 API provides strongly-typed classes in the +The Open XML SDK API provides strongly-typed classes in the DocumentFormat.OpenXML.WordprocessingML namespace that correspond to **WordprocessingML** elements. The following table lists some important **WordprocessingML** elements, the **WordprocessingML** document package part that the element corresponds to (where applicable) and the managed class that -represents the element in the Open XML SDK 2.5 API. +represents the element in the Open XML SDK API. -| **Package Part** | **WordprocessingML Element** | **Open XML SDK 2.5 Class** | **Description** | +| **Package Part** | **WordprocessingML Element** | **Open XML SDK Class** | **Description** | |---|---|---|---| | Main Document|document | [Document](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.document.aspx) | The root element for the main document part. | | Comments | comments | [Comments](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.comments.aspx) | The root element for the comments part. | @@ -104,7 +104,7 @@ t — A range of text. ### Open XML SDK Code Example -The following code uses the Open XML SDK 2.5 to create a simple **WordprocessingML** document that contains the text +The following code uses the Open XML SDK to create a simple **WordprocessingML** document that contains the text "Hello, Word!" ```csharp @@ -147,7 +147,7 @@ The following code uses the Open XML SDK 2.5 to create a simple **Wordprocessing ### Generated WordprocessingML -After you run the Open XML SDK 2.5 code in the previous section to +After you run the Open XML SDK code in the previous section to generate a document, you can explore the contents of the .zip package to view the **WordprocessingML** XML code. To view the .zip package, rename the extension on the minimum document from @@ -159,7 +159,7 @@ contains a single line of text.**Art placeholder**The document.xml file corresponds to the **WordprocessingML** main document part and it is this part that contains the content of the main body of the document. The following XML code is generated in the document.xml file when you -run the Open XML SDK 2.5 code in the previous section. +run the Open XML SDK code in the previous section. ```xml diff --git a/docs/what-s-new-in-the-open-xml-sdk.md b/docs/what-s-new-in-the-open-xml-sdk.md index 3a747e49..5cfcb5e1 100644 --- a/docs/what-s-new-in-the-open-xml-sdk.md +++ b/docs/what-s-new-in-the-open-xml-sdk.md @@ -5,7 +5,7 @@ api_name: api_type: - schema ms.assetid: 4fbda0e3-5676-4a8f-ba62-3fba59fa418b -title: What's new in the Open XML SDK 2.5 for Office +title: What's new in the Open XML SDK for Office ms.suite: office ms.author: o365devx @@ -15,12 +15,12 @@ ms.date: 11/01/2017 ms.localizationpriority: high --- -# What's new in the Open XML SDK 2.5 for Office +# What's new in the Open XML SDK for Office This topic describes the new and improved features included in the Open -XML SDK 2.5 for Office in addition to known issues and limitations. +XML SDK for Office in addition to known issues and limitations. -The Open XML SDK 2.5 is a collection of classes that let you create and +The Open XML SDK is a collection of classes that let you create and manipulate Open XML documents - documents that adhere to the [Office Open XML File Formats Standard](https://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=51463). Because the SDK provides an application program interface that lets you manipulate Open XML documents directly, you can do so without the need @@ -35,7 +35,7 @@ while adding new features. -------------------------------------------------------------------------------- ## System requirements -The Open XML SDK 2.5 has the following system requirements: +The Open XML SDK has the following system requirements: **Supported operating systems:** Windows 8 Preview, Windows 7, Windows Server 2003 Service Pack 2, Windows Server 2008 R2, Windows Server 2008 @@ -47,7 +47,7 @@ available disk space -------------------------------------------------------------------------------- ## New software requirements -Open XML SDK 2.5 requires .NET Framework 4.0 or the greater version. +Open XML SDK requires .NET Framework 4.0 or the greater version. Accordingly, the supported operating systems are updated to be the same as the requirements of the .NET Framework 4.0. @@ -55,10 +55,10 @@ as the requirements of the .NET Framework 4.0. -------------------------------------------------------------------------------- ## Support of Office 2013 Preview file format In addition to offering compatibility with the Open XML SDK 1.0 classes -and the Open XML SDK 2.0 for Microsoft Office classes, Open XML SDK 2.5 +and the Open XML SDK for Microsoft Office classes, Open XML SDK provides new classes that enable you to write and build applications to manipulate Open XML file extensions of the new Microsoft Office 2013 -features (see Table 1). By using the Open XML SDK 2.5 Productivity Tool +features (see Table 1). By using the Open XML SDK Productivity Tool for Office, those new extensions can be browsed inside the Open XML SDK documentation in the left pane. @@ -79,12 +79,12 @@ the Microsoft Developer Network. -------------------------------------------------------------------------------- ## Reads ISO Strict document files -The Open XML SDK 2.5 can read ISO/IEC 29500 Strict Format files. Its +The Open XML SDK can read ISO/IEC 29500 Strict Format files. Its document contents are recognized as an Open XML Transitional Format file when the document is opened. When the file is saved, the document is saved as an Open XML Transitional Format file. -The Open XML SDK 2.5 converts ISO Strict files to Transitional Formatted +The Open XML SDK converts ISO Strict files to Transitional Formatted files when any changes are made to the document or when the document is saved. Unless the document is saved or modified, the document is left as an ISO Strict Format file. @@ -94,9 +94,9 @@ an ISO Strict Format file. ## Updated API information Because the file format extension of Office 2013 extends members of the **\** element which did not have any -member elements, Open XML SDK 2.0 classes associated with the empty +member elements, Open XML SDK classes associated with the empty **\** (e.g. **DocumentFormat.OpenXml.Spreadsheet.PivotFilter:ExtensionList**) -are updated to the new variants of **ExtensionList** classes of Open XML SDK 2.5 (e.g. +are updated to the new variants of **ExtensionList** classes of Open XML SDK (e.g. **DocumentFormat.OpenXml.Spreadsheet.PivotFilter:PivotFilterExtensionList**). The following empty **ExtensionList** in each class are replaced with a new **ExtensionList** @@ -159,9 +159,9 @@ The following section discusses deprecated API members: ### Smart tags Because *smart tags* were deprecated in Office 2010, the Open XML SDK -2.5 doesn't support smart tag related Open XML elements. The Open XML -SDK 2.5 still can process smart tag elements as *unknown* elements, -however the Open XML SDK 2.5 Productivity Tool for Office validates +doesn't support smart tag related Open XML elements. The Open XML +SDK still can process smart tag elements as *unknown* elements, +however the Open XML SDK Productivity Tool for Office validates those elements (see the following list) in Office document files as *invalid tags*. @@ -191,9 +191,9 @@ DocumentFormat.OpenXml.Wordprocessing: ### Office 2010 Beta only tags -The Open XML SDK 2.0 classes for Office 2010 *beta only* Open XML tags +The Open XML SDK classes for Office 2010 *beta only* Open XML tags are deprecated. For example, the beta only non-visual properties of **DocumentFormat.OpenXml.Office2010.Drawing.ChartDrawing**, **DocumentFormat.OpenXml.Office2010.Word**, and **DocumentFormat.OpenXml.Office2010.Drawing** -have been removed from the Open XML SDK 2.5. +have been removed from the Open XML SDK. diff --git a/docs/word-processing.md b/docs/word-processing.md index 9b61a611..e50e1ad6 100644 --- a/docs/word-processing.md +++ b/docs/word-processing.md @@ -17,7 +17,7 @@ ms.localizationpriority: high # Word processing (Open XML SDK) -This section provides how-to topics for working with word processing documents using the Open XML SDK 2.5 for Office. +This section provides how-to topics for working with word processing documents using the Open XML SDK for Office. ## In this section @@ -78,4 +78,4 @@ This section provides how-to topics for working with word processing documents u ## Related sections - [How do I...](how-do-i.md) -- [Getting started with the Open XML SDK 2.5 for Office](getting-started.md) +- [Getting started with the Open XML SDK for Office](getting-started.md) diff --git a/docs/working-with-animation.md b/docs/working-with-animation.md index 09e8e8ea..06cf37af 100644 --- a/docs/working-with-animation.md +++ b/docs/working-with-animation.md @@ -17,7 +17,7 @@ ms.localizationpriority: medium # Working with animation (Open XML SDK) -This topic discusses the Open XML SDK 2.5 for Office **Animate** class and how it relates to the Open XML File Format PresentationML schema. For more information about the overall structure of the parts and elements that make up a PresentationML document, see [Structure of a PresentationML Document](structure-of-a-presentationml-document.md). +This topic discusses the Open XML SDK for Office **Animate** class and how it relates to the Open XML File Format PresentationML schema. For more information about the overall structure of the parts and elements that make up a PresentationML document, see [Structure of a PresentationML Document](structure-of-a-presentationml-document.md). ## Animation in PresentationML @@ -56,9 +56,9 @@ This element is a generic animation element that requires little or no semantic ``` -The following table lists the child elements of the \ element used when working with animation and the Open XML SDK 2.5 classes that correspond to them. +The following table lists the child elements of the \ element used when working with animation and the Open XML SDK classes that correspond to them. -| **PresentationML Element** | **Open XML SDK 2.5 Class** | +| **PresentationML Element** | **Open XML SDK Class** | |:---------------------------|:----------------------------| | \ | CommonBehavior | | \ | TimeAnimateValueList | @@ -73,7 +73,7 @@ The following table from the [ISO/IEC 29500](https://www.iso.org/iso/iso_catalog | to | This attribute specifies the ending value for the animation as a percentage.The possible values for this attribute are defined by the W3C XML Schema string data type. | | valueType | This attribute specifies the type of property value.The possible values for this attribute are defined by the ST_TLAnimateBehaviorValueType simple type (§19.7.21). | -## Open XML SDK 2.5 Animate Class +## Open XML SDK Animate Class The OXML SDK **Animate** class represents the \ element defined in the Open XML File Format schema for PresentationML documents. Use the **Animate** class to manipulate individual \ elements in a PresentationML document. @@ -138,7 +138,7 @@ The **Animate** class, which represents the \ element, is therefore also ## See also -[About the Open XML SDK 2.5 for Office](about-the-open-xml-sdk.md) +[About the Open XML SDK for Office](about-the-open-xml-sdk.md) [How to: Create a Presentation by Providing a File Name](how-to-create-a-presentation-document-by-providing-a-file-name.md) [How to: Insert a new slide into a presentation (Open XML SDK)](how-to-insert-a-new-slide-into-a-presentation.md) [How to: Delete a slide from a presentation (Open XML SDK)](how-to-delete-a-slide-from-a-presentation.md) diff --git a/docs/working-with-comments.md b/docs/working-with-comments.md index 594c9042..aec9619f 100644 --- a/docs/working-with-comments.md +++ b/docs/working-with-comments.md @@ -16,7 +16,7 @@ ms.localizationpriority: medium --- # Working with comments (Open XML SDK) -This topic discusses the Open XML SDK 2.5 for Office [Comment](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.comment.aspx) class and how it relates to the +This topic discusses the Open XML SDK for Office [Comment](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.comment.aspx) class and how it relates to the Open XML File Format PresentationML schema. For more information about the overall structure of the parts and elements that make up a PresentationML document, see [Structure of a PresentationML Document](structure-of-a-presentationml-document.md). @@ -48,9 +48,9 @@ Example: ``` -The following table lists the child elements of the \ element used when working with comments and the Open XML SDK 2.5 classes that correspond to them. +The following table lists the child elements of the \ element used when working with comments and the Open XML SDK classes that correspond to them. -| **PresentationML Element** | **Open XML SDK 2.5 Class** | +| **PresentationML Element** | **Open XML SDK Class** | |----------------------------|------------------------------------------------------------------------------------------------------------------------------------------| | \ | [ExtensionListWithModification](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.extensionlistwithmodification.aspx) | | \ | [Position](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.position.aspx) | @@ -65,7 +65,7 @@ specification describes the attributes of the \ element. | dt | This attribute specifies the date and time this comment was last modified.
The possible values for this attribute are defined by the W3C XML Schema **datetime** datatype. | | idx | This attribute specifies an identifier for this comment that is unique within a list of all comments by this author in this document. An author's first comment in a document has index 1.
Note: Because the index is unique only for the comment author, a document can contain multiple comments with the same index created by different authors.
The possible values for this attribute are defined by the ST_Index simple type (§19.7.3). | -## Open XML SDK 2.5 Comment Class +## Open XML SDK Comment Class The OXML SDK **Comment** class represents the \ element defined in the Open XML File Format schema for PresentationML documents. Use the **Comment** class to manipulate individual \ elements in a PresentationML document. @@ -148,7 +148,7 @@ The **Comment** class, which represents the \ element, is therefore also as ## Open XML SDK Code Example -The following code segment from the article [How to: Add a comment to a slide in a presentation](how-to-add-a-comment-to-a-slide-in-a-presentation.md) adds a new comments part to an existing slide in a presentation (if the slide does not already contain comments) and creates an instance of an Open XML SDK 2.0 **Comment** class in the slide comments part. It also adds a comment list to the comments part by creating an instance of the **CommentList** class, if one does not already exist; assigns an ID to the comment; and then adds a comment to the comment list by creating an instance of the **Comment** class, assigning the required attribute values. In addition, it creates instances of the **Position** and **Text** classes associated with the new **Comment** class instance. For the complete code sample, see the aforementioned article. +The following code segment from the article [How to: Add a comment to a slide in a presentation](how-to-add-a-comment-to-a-slide-in-a-presentation.md) adds a new comments part to an existing slide in a presentation (if the slide does not already contain comments) and creates an instance of an Open XML SDK **Comment** class in the slide comments part. It also adds a comment list to the comments part by creating an instance of the **CommentList** class, if one does not already exist; assigns an ID to the comment; and then adds a comment to the comment list by creating an instance of the **Comment** class, assigning the required attribute values. In addition, it creates instances of the **Position** and **Text** classes associated with the new **Comment** class instance. For the complete code sample, see the aforementioned article. ```csharp // Declare a comments part. @@ -237,7 +237,7 @@ The following code segment from the article [How to: Add a comment to a slide in ## Generated PresentationML -When the Open XML SDK 2.5 code in [How to: Add a comment to a slide in a presentation](how-to-add-a-comment-to-a-slide-in-a-presentation.md) is run, including +When the Open XML SDK code in [How to: Add a comment to a slide in a presentation](how-to-add-a-comment-to-a-slide-in-a-presentation.md) is run, including the segment shown in this article, the following XML is written to a new CommentAuthors.xml part in the existing PresentationML document referenced in the code, assuming that the document contained no comments or comment authors before the code was run. @@ -271,7 +271,7 @@ article. ## See also -[About the Open XML SDK 2.5 for Office](about-the-open-xml-sdk.md) +[About the Open XML SDK for Office](about-the-open-xml-sdk.md) [How to: Create a Presentation by Providing a File Name](how-to-create-a-presentation-document-by-providing-a-file-name.md) [How to: Add a comment to a slide in a presentation (Open XML SDK)](how-to-add-a-comment-to-a-slide-in-a-presentation.md) [How to: Delete all the comments by an author from all the slides in a presentation (Open XML SDK)](how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentatio.md) diff --git a/docs/working-with-conditional-formatting.md b/docs/working-with-conditional-formatting.md index f27ed230..b89edb99 100644 --- a/docs/working-with-conditional-formatting.md +++ b/docs/working-with-conditional-formatting.md @@ -16,7 +16,7 @@ ms.localizationpriority: medium --- # Working with conditional formatting (Open XML SDK) -This topic discusses the Open XML SDK 2.5 **[ConditionalFormatting](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.conditionalformatting.aspx)** class and how it +This topic discusses the Open XML SDK **[ConditionalFormatting](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.conditionalformatting.aspx)** class and how it relates to the Open XML File Format SpreadsheetML schema. For more information about the overall structure of the parts and elements that make up a SpreadsheetML document, see [Structure of a SpreadsheetML document (Open XML SDK)](structure-of-a-spreadsheetml-document.md)**. @@ -39,12 +39,12 @@ applied to a cell or series of cells. The collection of cells on which the format is applied is defined using the **sqref** attribute. The **sqref** attribute specifies a cell range using the 'from:to' notation, for example 'A1:A10'. -The following table lists the common Open XML SDK 2.5 classes used when +The following table lists the common Open XML SDK classes used when working with the **ConditionalFormatting** class. -| **SpreadsheetML Element** | **Open XML SDK 2.5 Class** | +| **SpreadsheetML Element** | **Open XML SDK Class** | |---------------------------|------------------------------------------------------------------------------------------------------------------------------------------------| | cfRule | [ConditionalFormattingRule](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.conditionalformattingrule.aspx) | | dataBar | [DataBar](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.databar.aspx) | @@ -52,8 +52,8 @@ class. | iconSet | [IconSet](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.iconset.aspx) | -------------------------------------------------------------------------------- -## Open XML SDK 2.5 Conditional Formatting Class -The Open XML SDK 2.5**ConditionalFormatting** +## Open XML SDK Conditional Formatting Class +The Open XML SDK**ConditionalFormatting** class represents the table (\<**conditionalFormatting**\>) element defined in the Open XML File Format schema for SpreadsheetML documents. Use the **ConditionalFormatting** class to manipulate individual \<**conditionalFormatting**\> diff --git a/docs/working-with-formulas.md b/docs/working-with-formulas.md index 93e8991e..0a98ff68 100644 --- a/docs/working-with-formulas.md +++ b/docs/working-with-formulas.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Working with formulas (Open XML SDK) -This topic discusses the Open XML SDK 2.5 [CellFormula](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.cellformula.aspx) class and how it relates to the +This topic discusses the Open XML SDK [CellFormula](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.cellformula.aspx) class and how it relates to the Open XML File Format SpreadsheetML schema. For more information about the overall structure of the parts and elements that make up a SpreadsheetML document, see [Structure of a diff --git a/docs/working-with-handout-master-slides.md b/docs/working-with-handout-master-slides.md index 6a784449..3bb9749f 100644 --- a/docs/working-with-handout-master-slides.md +++ b/docs/working-with-handout-master-slides.md @@ -16,7 +16,7 @@ ms.localizationpriority: medium --- # Working with handout master slides (Open XML SDK) -This topic discusses the Open XML SDK 2.5 for Office [HandoutMaster](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.handoutmaster.aspx) class and how it relates to the Open XML File Format PresentationML schema. For more information about the overall structure of the parts and elements that make up a PresentationML document, see [Structure of a PresentationML document (Open XML SDK)](structure-of-a-presentationml-document.md). +This topic discusses the Open XML SDK for Office [HandoutMaster](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.handoutmaster.aspx) class and how it relates to the Open XML File Format PresentationML schema. For more information about the overall structure of the parts and elements that make up a PresentationML document, see [Structure of a PresentationML document (Open XML SDK)](structure-of-a-presentationml-document.md). ## Handout Master Slides in PresentationML The [ISO/IEC 29500](https://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=51463) specification describes the Open XML PresentationML \ @@ -34,19 +34,19 @@ majority of the intended purpose for a handoutMaster slide. The following table lists the child elements of the \ element used when working with handout master slides and the Open XML -SDK 2.5 classes that correspond to them. +SDK classes that correspond to them. -| **PresentationML Element** | **Open XML SDK 2.5 Class** | +| **PresentationML Element** | **Open XML SDK Class** | |----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------| | \ | [ColorMap](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.colormap.aspx) | | \ | [CommonSlideData](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.commonslidedata.aspx) | | \ | [ExtensionListWithModification](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.extensionlistwithmodification.aspx) | | \ | [HeaderFooter](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.headerfooter.aspx) | -## Open XML SDK 2.5 HandoutMaster Class +## Open XML SDK HandoutMaster Class -The Open XML SDK 2.5 **HandoutMaster** class represents the \ element defined in the Open XML File Format schema for PresentationML documents. Use the **HandoutMaster** class to manipulate individual \ elements in a PresentationML document. +The Open XML SDK **HandoutMaster** class represents the \ element defined in the Open XML File Format schema for PresentationML documents. Use the **HandoutMaster** class to manipulate individual \ elements in a PresentationML document. Classes commonly associated with the **HandoutMaster** class are shown in the following sections. @@ -134,7 +134,7 @@ following code sample, are the **CommonSlideData** class, the **ColorMap** class ## Open XML SDK Code Example The following method adds a new handout master part to an existing -presentation and creates an instance of an Open XML SDK 2.5**HandoutMaster** class in the new handout master +presentation and creates an instance of an Open XML SDK**HandoutMaster** class in the new handout master part. The **HandoutMaster** class constructor creates instances of the **CommonSlideData** class and the **ColorMap** class. The **CommonSlideData** class constructor creates an @@ -219,7 +219,7 @@ namespace. ## Generated PresentationML -When the Open XML SDK 2.5 code is run, the following XML is written to +When the Open XML SDK code is run, the following XML is written to the PresentationML document referenced in the code. ```xml @@ -276,7 +276,7 @@ the PresentationML document referenced in the code. ## See also -[About the Open XML SDK 2.5 for Office](about-the-open-xml-sdk.md) +[About the Open XML SDK for Office](about-the-open-xml-sdk.md) [How to: Create a presentation document by providing a file name (Open XML SDK)](how-to-create-a-presentation-document-by-providing-a-file-name.md) [How to: Insert a new slide into a presentation (Open XML SDK)](how-to-insert-a-new-slide-into-a-presentation.md) [How to: Delete a slide from a presentation (Open XML SDK)](how-to-delete-a-slide-from-a-presentation.md) diff --git a/docs/working-with-notes-slides.md b/docs/working-with-notes-slides.md index 89e5867c..e927cfcb 100644 --- a/docs/working-with-notes-slides.md +++ b/docs/working-with-notes-slides.md @@ -16,7 +16,7 @@ ms.localizationpriority: medium --- # Working with notes slides (Open XML SDK) -This topic discusses the Open XML SDK 2.5 for Office [NotesSlide](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.notesslide.aspx) class and how it relates to the +This topic discusses the Open XML SDK for Office [NotesSlide](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.notesslide.aspx) class and how it relates to the Open XML File Format PresentationML schema. @@ -55,11 +55,11 @@ parts and elements that make up a PresentationML document, see [Structure of a PresentationML Document](structure-of-a-presentationml-document.md). The following table lists the child elements of the \ element -used when working with notes slides and the Open XML SDK 2.5 classes +used when working with notes slides and the Open XML SDK classes that correspond to them. -| **PresentationML Element** | **Open XML SDK 2.5 Class** | +| **PresentationML Element** | **Open XML SDK Class** | |----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------| | \ | [ColorMapOverride](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.colormapoverride.aspx) | | \ | [CommonSlideData](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.commonslidedata.aspx) | @@ -78,7 +78,7 @@ specification describes the attributes of the \ element. --------------------------------------------------------------------------------- -## Open XML SDK 2.5 NotesSlide Class +## Open XML SDK NotesSlide Class The OXML SDK **NotesSlide** class represents the \ element defined in the Open XML File Format schema for PresentationML documents. Use the **NotesSlide** class to manipulate individual @@ -164,7 +164,7 @@ the **CommonSlideData** class. -------------------------------------------------------------------------------- ## Open XML SDK Code Example The following method adds a new notes slide part to an existing -presentation and creates an instance of an Open XML SDK 2.5**NotesSlide** class in the new notes slide part. The +presentation and creates an instance of an Open XML SDK**NotesSlide** class in the new notes slide part. The **NotesSlide** class constructor creates instances of the **CommonSlideData** class and the **ColorMap** class. The **CommonSlideData** class constructor creates an @@ -225,7 +225,7 @@ namespace. --------------------------------------------------------------------------------- ## Generated PresentationML -When the Open XML SDK 2.0 code is run, the following XML is written to +When the Open XML SDK code is run, the following XML is written to the PresentationML document referenced in the code. ```xml @@ -275,7 +275,7 @@ the PresentationML document referenced in the code. ## See also -[About the Open XML SDK 2.5 for Office](about-the-open-xml-sdk.md) +[About the Open XML SDK for Office](about-the-open-xml-sdk.md) [How to: Create a Presentation by Providing a File Name](how-to-create-a-presentation-document-by-providing-a-file-name.md) diff --git a/docs/working-with-paragraphs.md b/docs/working-with-paragraphs.md index 111e8e48..a4b22cf1 100644 --- a/docs/working-with-paragraphs.md +++ b/docs/working-with-paragraphs.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Working with paragraphs (Open XML SDK) -This topic discusses the Open XML SDK 2.5 [Paragraph](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.paragraph.aspx) class and how it relates to the +This topic discusses the Open XML SDK [Paragraph](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.paragraph.aspx) class and how it relates to the Open XML File Format WordprocessingML schema. @@ -45,7 +45,7 @@ The following table lists the most common Open XML SDK classes used when working with paragraphs. -| **WordprocessingML element** | **Open XML SDK 2.5 Class** | +| **WordprocessingML element** | **Open XML SDK Class** | |------------------------------|----------------------------| | **p** | Paragraph | | **pPr** | ParagraphProperties | @@ -54,7 +54,7 @@ working with paragraphs. --------------------------------------------------------------------------------- ## Paragraph Class -The Open XML SDK 2.5 [Paragraph](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.paragraph.aspx) class represents the paragraph +The Open XML SDK [Paragraph](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.paragraph.aspx) class represents the paragraph (\<**p**\>) element defined in the Open XML File Format schema for WordprocessingML documents as discussed above. Use the **Paragraph** object to manipulate @@ -84,7 +84,7 @@ makes up the document content. The OXML SDK [Text](https://msdn.microsoft.com/li -------------------------------------------------------------------------------- ## Open XML SDK Code Example -The following code instantiates an Open XML SDK 2.5**Paragraph** object and then uses it to add text to +The following code instantiates an Open XML SDK**Paragraph** object and then uses it to add text to a WordprocessingML document. ```csharp @@ -137,7 +137,7 @@ WordprocessingML document referenced in the code. ## See also -[About the Open XML SDK 2.5 for Office](about-the-open-xml-sdk.md) +[About the Open XML SDK for Office](about-the-open-xml-sdk.md) [Working with runs (Open XML SDK)](working-with-runs.md) diff --git a/docs/working-with-pivottables.md b/docs/working-with-pivottables.md index 0498b427..1288400b 100644 --- a/docs/working-with-pivottables.md +++ b/docs/working-with-pivottables.md @@ -17,7 +17,7 @@ ms.localizationpriority: high # Working with PivotTables (Open XML SDK) -This topic discusses the Open XML SDK 2.5 **[PivotTableDefinition](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.pivottabledefinition.aspx)** class and how it relates to the Open XML File Format SpreadsheetML schema. For more information about the overall structure of the parts and elements that make up a SpreadsheetML document, see [Structure of a SpreadsheetML document (Open XML SDK)](structure-of-a-spreadsheetml-document.md). +This topic discusses the Open XML SDK **[PivotTableDefinition](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.pivottabledefinition.aspx)** class and how it relates to the Open XML File Format SpreadsheetML schema. For more information about the overall structure of the parts and elements that make up a SpreadsheetML document, see [Structure of a SpreadsheetML document (Open XML SDK)](structure-of-a-spreadsheetml-document.md). ## PivotTable in SpreadsheetML @@ -85,17 +85,17 @@ is displayed in the cells of a worksheet and therefore you need to construct them as well. You can also have the user update the PivotTable cells when opening the document. -The following table lists the common Open XML SDK 2.5 classes used when working with the **PivotTableDefinition** class. +The following table lists the common Open XML SDK classes used when working with the **PivotTableDefinition** class. -| **SpreadsheetML Element** | **Open XML SDK 2.5 Class** | +| **SpreadsheetML Element** | **Open XML SDK Class** | |---------------------------|-------------------------------------------------------------------------------------------------------------------| | pivotField | [PivotField](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.pivotfield.aspx) | | pivotCacheDefinition | [PivotCacheDefinition](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.pivotcachedefinition.aspx) | | pivotCacheRecords | [PivotCacheRecords](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.pivotcacherecords.aspx) | -## Open XML SDK 2.5 PivotTableDefinition Class +## Open XML SDK PivotTableDefinition Class -The Open XML SDK 2.5**PivotTableDefinition** +The Open XML SDK**PivotTableDefinition** class represents the PivotTable definition (\<**pivotTableDefinition**\>) element defined in the Open XML File Format schema for SpreadsheetML documents. Use the **PivotTableDefinition** class to manipulate individual \<**pivotTableDefinition**\> elements in a SpreadsheetML document. The main function of the PivotTable definition is to store information diff --git a/docs/working-with-presentation-slides.md b/docs/working-with-presentation-slides.md index 24b396b6..00fa3fee 100644 --- a/docs/working-with-presentation-slides.md +++ b/docs/working-with-presentation-slides.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Working with presentation slides (Open XML SDK) -This topic discusses the Open XML SDK 2.5 for Office [Slide](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slide.aspx) class and how it relates to the Open +This topic discusses the Open XML SDK for Office [Slide](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slide.aspx) class and how it relates to the Open XML File Format PresentationML schema. For more information about the overall structure of the parts and elements that make up a PresentationML document, see [Structure of a @@ -59,11 +59,11 @@ part. For more information about the overall structure of the parts and elements that make up a PresentationML document, see [Structure of a PresentationML Document](structure-of-a-presentationml-document.md). The following table lists the child elements of the \ element used -when working with presentation slides and the Open XML SDK 2.5 classes +when working with presentation slides and the Open XML SDK classes that correspond to them. -| **PresentationML Element** | **Open XML SDK 2.5 Class** | +| **PresentationML Element** | **Open XML SDK Class** | |----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------| | \ | [ColorMapOverride](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.colormapoverride.aspx) | | \ | [CommonSlideData](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.commonslidedata.aspx) | @@ -72,8 +72,8 @@ that correspond to them. | \ | [Transition](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.transition.aspx) | -------------------------------------------------------------------------------- -## Open XML SDK 2.5 Slide Class -The Open XML SDK 2.5**Slide** class represents the \ element +## Open XML SDK Slide Class +The Open XML SDK**Slide** class represents the \ element defined in the Open XML File Format schema for PresentationML documents. Use the **Slide** object to manipulate individual \ elements in a PresentationML document. @@ -184,7 +184,7 @@ these classes, as shown in the following code example, are the **CommonSlideData ## Open XML SDK Code Example The following method from the article [How to: Create a presentation document by providing a file name (Open XML SDK)](how-to-create-a-presentation-document-by-providing-a-file-name.md)** adds a new slide part to an existing presentation and creates an instance of the Open XML -SDK 2.5**Slide** class in the new slide part. +SDK **Slide** class in the new slide part. The **Slide** class constructor creates instances of the **CommonSlideData** and **ColorMapOverride** classes. The **CommonSlideData** class constructor creates an instance of the **ShapeTree** class, whose @@ -323,7 +323,7 @@ is written to the PresentationML document file referenced in the code. ## See also -[About the Open XML SDK 2.5 for Office](about-the-open-xml-sdk.md) +[About the Open XML SDK for Office](about-the-open-xml-sdk.md) [How to: Insert a new slide into a presentation (Open XML SDK)](how-to-insert-a-new-slide-into-a-presentation.md) diff --git a/docs/working-with-presentations.md b/docs/working-with-presentations.md index c9d20a2b..731c9931 100644 --- a/docs/working-with-presentations.md +++ b/docs/working-with-presentations.md @@ -16,7 +16,7 @@ ms.localizationpriority: medium --- # Working with presentations (Open XML SDK) -This topic discusses the Open XML SDK 2.5 for Office [Presentation](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.presentation.aspx) class and how it relates to +This topic discusses the Open XML SDK for Office [Presentation](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.presentation.aspx) class and how it relates to the Open XML File Format PresentationML schema. For more information about the overall structure of the parts and elements that make up a PresentationML document, see [Structure of a @@ -70,10 +70,10 @@ the parts and elements that make up a PresentationML document, see The following table lists some of the most common child elements of the \ element used when working with presentations and the -Open XML SDK 2.5 classes that correspond to them. +Open XML SDK classes that correspond to them. -| **PresentationML Element** | **Open XML SDK 2.5 Class** | +| **PresentationML Element** | **Open XML SDK Class** | |----------------------------|-------------------------------------------------------------------------------------------------------------------------------------| | \ | [SlideMasterIdList](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slidemasteridlist.aspx) | | \ | [SlideMasterId](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slidemasterid.aspx) | @@ -87,8 +87,8 @@ Open XML SDK 2.5 classes that correspond to them. | \ | [DefaultTextStyle](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.defaulttextstyle.aspx) | -------------------------------------------------------------------------------- -## Open XML SDK 2.5 Presentation Class -The Open XML SDK 2.5**Presentation** class +## Open XML SDK Presentation Class +The Open XML SDK**Presentation** class represents the \ element defined in the Open XML File Format schema for PresentationML documents. Use the **Presentation** class to manipulate an individual \ element in a PresentationML document. @@ -327,7 +327,7 @@ code example, are the **SlideMasterIdList**, ## Open XML SDK Code Example The following code example from the article [How to: Create a presentation document by providing a file name (Open XML SDK)](how-to-create-a-presentation-document-by-providing-a-file-name.md) uses the [Create(String, PresentationDocumentType)](https://msdn.microsoft.com/library/office/cc535977.aspx) method of the [PresentationDocument](https://msdn.microsoft.com/library/office/documentformat.openxml.packaging.presentationdocument.aspx) class of the Open XML -SDK 2.5 to create an instance of that same class that has the specified +SDK to create an instance of that same class that has the specified name and file path. Then it uses the [AddPresentationPart()](https://msdn.microsoft.com/library/office/documentformat.openxml.packaging.presentationdocument.addpresentationpart.aspx) method to add an instance of the [PresentationPart](https://msdn.microsoft.com/library/office/documentformat.openxml.packaging.presentationpart.aspx) class to the document file. Next, it creates an instance of the [Presentation](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.presentation.aspx) class that represents the @@ -430,7 +430,7 @@ PresentationML document referenced in the code. ## See also -[About the Open XML SDK 2.5 for Office](about-the-open-xml-sdk.md) +[About the Open XML SDK for Office](about-the-open-xml-sdk.md) [How to: Create a presentation document by providing a file name (Open XML SDK)](how-to-create-a-presentation-document-by-providing-a-file-name.md) diff --git a/docs/working-with-runs.md b/docs/working-with-runs.md index 1f4f0e62..57e438c8 100644 --- a/docs/working-with-runs.md +++ b/docs/working-with-runs.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Working with runs (Open XML SDK) -This topic discusses the Open XML SDK 2.5 **[Run](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.run.aspx)** class and how it relates to the Open +This topic discusses the Open XML SDK **[Run](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.run.aspx)** class and how it relates to the Open XML File Format WordprocessingML schema. @@ -50,7 +50,7 @@ The following table lists the most common Open XML SDK classes used when working with runs. -| **XML element** | **Open XML SDK 2.0 Class** | +| **XML element** | **Open XML SDK Class** | |-----------------|----------------------------| | **p** | Paragraph | | **rPr** | RunProperties | @@ -58,7 +58,7 @@ working with runs. --------------------------------------------------------------------------------- ## Run Class -The Open XML SDK 2.5[Run](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.run.aspx) class represents the run (\<**r**\>) element defined in the Open XML File Format +The Open XML SDK[Run](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.run.aspx) class represents the run (\<**r**\>) element defined in the Open XML File Format schema for WordprocessingML documents as discussed above. Use a **Run** object to manipulate an individual \<**r**\> element in a WordprocessingML document. ### RunProperties Class @@ -142,7 +142,7 @@ WordprocessingML document specified in the preceding code. ## See also -[About the Open XML SDK 2.5 for Office](about-the-open-xml-sdk.md) +[About the Open XML SDK for Office](about-the-open-xml-sdk.md) [Working with paragraphs (Open XML SDK)](working-with-paragraphs.md) diff --git a/docs/working-with-sheets.md b/docs/working-with-sheets.md index b0646233..0407317e 100644 --- a/docs/working-with-sheets.md +++ b/docs/working-with-sheets.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Working with sheets (Open XML SDK) -This topic discusses the Open XML SDK 2.5 [Worksheet](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.worksheet.aspx), [Chartsheet](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.chartsheet.aspx), and [DialogSheet](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.dialogsheet.aspx) classes and how they relate to +This topic discusses the Open XML SDK [Worksheet](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.worksheet.aspx), [Chartsheet](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.chartsheet.aspx), and [DialogSheet](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.dialogsheet.aspx) classes and how they relate to the Open XML File Format SpreadsheetML schema. For more information about the overall structure of the parts and elements that make up a SpreadsheetML document, see [Structure of a SpreadsheetML document (Open XML SDK)](structure-of-a-spreadsheetml-document.md). @@ -43,9 +43,9 @@ Other types of sheets include chart sheets and dialog sheets. © ISO/IEC29500: 2008. -## Open XML SDK 2.5 Worksheet Class +## Open XML SDK Worksheet Class -The Open XML SDK 2.5**Worksheet** class +The Open XML SDK**Worksheet** class represents the **worksheet** (\<**worksheet**\>) element defined in the Open XML File Format schema for SpreadsheetML documents. Use the **Worksheet** class to manipulate individual \<**worksheet**\> elements in a SpreadsheetML document. @@ -104,10 +104,10 @@ the XML file. If the value is a string value, it is stored in a shared string table. For more information about using the shared string table to store string values, see [Working with the shared string table (Open XML SDK)](working-with-the-shared-string-table.md). -The following table lists the common Open XML SDK 2.5 classes used when +The following table lists the common Open XML SDK classes used when working with the [Worksheet](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.worksheet.aspx) class. -| **SpreadsheetML Element** | **Open XML SDK 2.5 Class** | +| **SpreadsheetML Element** | **Open XML SDK Class** | |---|---| | sheetData | [SheetData](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.sheetdata.aspx) | | row | [Row](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.row.aspx) | @@ -328,10 +328,10 @@ relationship in the Chartsheet part's relationship item: © ISO/IEC29500: 2008. -The following table lists the common Open XML SDK 2.5 classes used when +The following table lists the common Open XML SDK classes used when working with the [Chartsheet](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.chartsheet.aspx) class. -| **SpreadsheetML Element** | **Open XML SDK 2.5 Class** | +| **SpreadsheetML Element** | **Open XML SDK Class** | |---|---| | drawing | [Drawing](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.drawing.aspx) | @@ -352,7 +352,7 @@ be only one Drawings part per worksheet or chartsheet. © ISO/IEC29500: 2008. -## Open XML SDK 2.5 Dialogsheet Class +## Open XML SDK Dialogsheet Class The following information from the ISO/IEC 29500 specification introduces the **dialogsheet** (\<**dialogsheet**\>) element. diff --git a/docs/working-with-slide-layouts.md b/docs/working-with-slide-layouts.md index 16112453..fa21c417 100644 --- a/docs/working-with-slide-layouts.md +++ b/docs/working-with-slide-layouts.md @@ -17,7 +17,7 @@ ms.localizationpriority: medium # Working with slide layouts (Open XML SDK) -This topic discusses the Open XML SDK 2.5 for Office [SlideLayout](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slidelayout.aspx) class and how it relates to the Open XML File Format PresentationML schema. +This topic discusses the Open XML SDK for Office [SlideLayout](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slidelayout.aspx) class and how it relates to the Open XML File Format PresentationML schema. ## Slide Layouts in PresentationML @@ -34,10 +34,10 @@ the parts and elements that make up a PresentationML document, see [Structure of a PresentationML Document](structure-of-a-presentationml-document.md). The following table lists the child elements of the \ -element used when working with slide layouts and the Open XML SDK 2.5 +element used when working with slide layouts and the Open XML SDK classes that correspond to them. -| **PresentationML Element** | **Open XML SDK 2.5 Class** | +| **PresentationML Element** | **Open XML SDK Class** | |----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------| | \ | [ColorMapOverride](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.colormapoverride.aspx) | | \ | [CommonSlideData](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.commonslidedata.aspx) | @@ -59,7 +59,7 @@ specification describes the attributes of the \ element. | type (Slide Layout Type) | Specifies the slide layout type that is used by this slide.
The possible values for this attribute are defined by the ST_SlideLayoutType simple type (§19.7.15). | | userDrawn (Is User Drawn) | Specifies if the corresponding object has been drawn by the user and should thus not be deleted. This allows for the flagging of slides that contain user drawn data.
The possible values for this attribute are defined by the W3C XML Schema **boolean** datatype. | -## The Open XML SDK 2.5 SlideLayout Class +## The Open XML SDK SlideLayout Class The OXML SDK **SlideLayout** class represents the \ element defined in the Open XML File Format schema for @@ -166,7 +166,7 @@ the **CommonSlideData** class, the **ColorMapOverride** class, the [ShapeTree](h ## Open XML SDK Code Example -The following method from the article [How to: Create a presentation document by providing a file name (Open XML SDK)](how-to-create-a-presentation-document-by-providing-a-file-name.md) adds a new slide layout part to an existing presentation and creates an instance of an Open XML SDK 2.5**SlideLayout** class in the new slide layout part. The **SlideLayout** class constructor creates instances of the **CommonSlideData** class and the **ColorMapOverride** class. The **CommonSlideData** class constructor creates an instance of the [ShapeTree](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.shapetree.aspx) class, whose constructor in turn creates additional class instances: an instance of the [NonVisualGroupShapeProperties (https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.nonvisualgroupshapeproperties.aspx) class, an instance of the [GroupShapeProperties](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.groupshapeproperties.aspx) class, and an instance of the [Shape](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.shape.aspx) class. +The following method from the article [How to: Create a presentation document by providing a file name (Open XML SDK)](how-to-create-a-presentation-document-by-providing-a-file-name.md) adds a new slide layout part to an existing presentation and creates an instance of an Open XML SDK**SlideLayout** class in the new slide layout part. The **SlideLayout** class constructor creates instances of the **CommonSlideData** class and the **ColorMapOverride** class. The **CommonSlideData** class constructor creates an instance of the [ShapeTree](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.shapetree.aspx) class, whose constructor in turn creates additional class instances: an instance of the [NonVisualGroupShapeProperties (https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.nonvisualgroupshapeproperties.aspx) class, an instance of the [GroupShapeProperties](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.groupshapeproperties.aspx) class, and an instance of the [Shape](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.shape.aspx) class. The namespace represented by the letter *P* in the code is the [DocumentFormat.OpenXml.Presentation (https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.aspx) namespace. @@ -265,6 +265,6 @@ When the Open XML SDK code is run, the following XML is written to the Presentat ## See also -[About the Open XML SDK 2.5 for Office](about-the-open-xml-sdk.md) +[About the Open XML SDK for Office](about-the-open-xml-sdk.md) [How to: Create a Presentation by Providing a File Name](how-to-create-a-presentation-document-by-providing-a-file-name.md) [How to: Apply a theme to a presentation (Open XML SDK)](how-to-apply-a-theme-to-a-presentation.md) diff --git a/docs/working-with-slide-masters.md b/docs/working-with-slide-masters.md index ded5dc02..68d04584 100644 --- a/docs/working-with-slide-masters.md +++ b/docs/working-with-slide-masters.md @@ -17,7 +17,7 @@ ms.localizationpriority: medium # Working with slide masters (Open XML SDK) -This topic discusses the Open XML SDK 2.5 for Office **[SlideMaster](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slidemaster.aspx)** class and how it relates to the Open XML File Format PresentationML schema. +This topic discusses the Open XML SDK for Office **[SlideMaster](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.slidemaster.aspx)** class and how it relates to the Open XML File Format PresentationML schema. ## Slide Masters in PresentationML @@ -27,9 +27,9 @@ This element specifies an instance of a slide master slide. Within a slide maste The \ element is the root element of the PresentationML Slide Master part. For more information about the overall structure of the parts and elements that make up a PresentationML document, see [Structure of a PresentationML Document](structure-of-a-presentationml-document.md). -The following table lists the child elements of the \ element used when working with slide masters and the Open XML SDK 2.5 classes that correspond to them. +The following table lists the child elements of the \ element used when working with slide masters and the Open XML SDK classes that correspond to them. -| **PresentationML Element** | **Open XML SDK 2.5 Class** | +| **PresentationML Element** | **Open XML SDK Class** | |:---------------------------|:---------------------------------------------------------------------------------------------------------------------------| | \ | [ColorMap](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.colormap.aspx) | | \ | [CommonSlideData](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.commonslidedata.aspx) | @@ -47,9 +47,9 @@ specification describes the attributes of the \ element. |----------------------------|----------------------------------------------------| | preserve (Preserve Slide Master) | Specifies whether the corresponding slide layout is deleted when all the slides that follow that layout are deleted. If this attribute is not specified then a value of **false** should be assumed by the generating application. This would mean that the slide would in fact be deleted if no slides within the presentation were related to it.
The possible values for this attribute are defined by the W3C XML Schema **Boolean** data type. | -## Open XML SDK 2.5 SlideMaster Class +## Open XML SDK SlideMaster Class -The Open XML SDK 2.5**SlideMaster** class +The Open XML SDK**SlideMaster** class represents the \ element defined in the Open XML File Format schema for PresentationML documents. Use the **SlideMaster** class to manipulate individual \ elements in a PresentationML document. @@ -146,7 +146,7 @@ element. Among these classes, as shown in the following code sample, are the **C ## Open XML SDK Code Example -The following method from the article [How to: Create a presentation document by providing a file name](/office/open-xml/how-to-create-a-presentation-document-by-providing-a-file-name) adds a new slidemaster part to an existing presentation and creates an instance of an Open XML SDK 2.5**SlideMaster** class in the new slide master part. The **SlideMaster** class constructor creates instances of the **CommonSlideData** class and the **ColorMap**, **SlideLayoutIdList**, and **TextStyles** classes. The **CommonSlideData** class constructor creates an instance of the **[ShapeTree](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.shapetree.aspx)** class, whose constructor in turn creates additional class instances: an instance of the **[NonVisualGroupShapeProperties](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.nonvisualgroupshapeproperties.aspx)** class, an instance of the **[GroupShapeProperties](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.groupshapeproperties.aspx)** class, and an instance of the **[Shape](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.shape.aspx)** class, among others. +The following method from the article [How to: Create a presentation document by providing a file name](/office/open-xml/how-to-create-a-presentation-document-by-providing-a-file-name) adds a new slidemaster part to an existing presentation and creates an instance of an Open XML SDK**SlideMaster** class in the new slide master part. The **SlideMaster** class constructor creates instances of the **CommonSlideData** class and the **ColorMap**, **SlideLayoutIdList**, and **TextStyles** classes. The **CommonSlideData** class constructor creates an instance of the **[ShapeTree](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.shapetree.aspx)** class, whose constructor in turn creates additional class instances: an instance of the **[NonVisualGroupShapeProperties](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.nonvisualgroupshapeproperties.aspx)** class, an instance of the **[GroupShapeProperties](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.groupshapeproperties.aspx)** class, and an instance of the **[Shape](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.shape.aspx)** class, among others. The namespace represented by the letter *P* in the code is the **[DocumentFormat.OpenXml.Presentation](https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.aspx)** namespace. @@ -282,7 +282,7 @@ When the Open XML SDK code is run, the following XML is written to the Presentat ## See also -[About the Open XML SDK 2.5 for Office](about-the-open-xml-sdk.md) +[About the Open XML SDK for Office](about-the-open-xml-sdk.md) [How to: Create a Presentation by Providing a File Name](how-to-create-a-presentation-document-by-providing-a-file-name.md) [How to: Insert a new slide into a presentation (Open XML SDK)](how-to-insert-a-new-slide-into-a-presentation.md) [How to: Delete a slide from a presentation (Open XML SDK)](how-to-delete-a-slide-from-a-presentation.md) diff --git a/docs/working-with-tables.md b/docs/working-with-tables.md index 72ec9dc3..0c30c831 100644 --- a/docs/working-with-tables.md +++ b/docs/working-with-tables.md @@ -17,7 +17,7 @@ ms.localizationpriority: high # Working with SpreadsheetML tables (Open XML SDK) -This topic discusses the Open XML SDK 2.5 **[Table](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.table.aspx)** class and how it relates to the Open +This topic discusses the Open XML SDK **[Table](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.table.aspx)** class and how it relates to the Open XML File Format SpreadsheetML schema. For more information about the overall structure of the parts and elements that make up a SpreadsheetML document, see [Structure of a SpreadsheetML document @@ -64,16 +64,16 @@ in a separate part inside the package. The table part does not contain any table data. The data is maintained in the worksheet cells. For more information about data is stored in the worksheet, see [Working with sheets (Open XML SDK)](working-with-sheets.md). -The following table lists the common Open XML SDK 2.5 classes used when working with the **Table** class. +The following table lists the common Open XML SDK classes used when working with the **Table** class. -| **SpreadsheetML Element** | **Open XML SDK 2.5 Class** | +| **SpreadsheetML Element** | **Open XML SDK Class** | |---------------------------|------------------------------------------------------------------------------------------------------------------------| | tableColumn | [TableColumn](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.tablecolumn.aspx) | | autoFilter | [AutoFilter](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.table.autofilter.aspx) | -## Open XML SDK 2.5 Table Class +## Open XML SDK Table Class -The Open XML SDK 2.5**Table** class represents +The Open XML SDK**Table** class represents the table (\<**table**\>) element defined in the Open XML File Format schema for SpreadsheetML documents. Use the **Table** class to manipulate individual diff --git a/docs/working-with-the-calculation-chain.md b/docs/working-with-the-calculation-chain.md index 8eb2f549..88e0a831 100644 --- a/docs/working-with-the-calculation-chain.md +++ b/docs/working-with-the-calculation-chain.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Working with the calculation chain (Open XML SDK) -This topic discusses the Open XML SDK 2.5 [CalculationChain](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.calculationchain.aspx) class and how it relates +This topic discusses the Open XML SDK [CalculationChain](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.calculationchain.aspx) class and how it relates to the Open XML File Format SpreadsheetML schema. For more information about the overall structure of the parts and elements that make up a SpreadsheetML document, see [Structure of a SpreadsheetML document (Open XML SDK)](structure-of-a-spreadsheetml-document.md). @@ -69,17 +69,17 @@ performed at runtime. © ISO/IEC29500: 2008. -The following table lists the common Open XML SDK 2.5 classes used when +The following table lists the common Open XML SDK classes used when working with the **CalculationChain** class. -| **SpreadsheetML Element** | **Open XML SDK 2.5 Class** | +| **SpreadsheetML Element** | **Open XML SDK Class** | |---------------------------|----------------------------| | c | CalculationCell | -## Open XML SDK 2.5 CalculationChain Class +## Open XML SDK CalculationChain Class -The Open XML SDK 2.5**CalculationChain** class +The Open XML SDK**CalculationChain** class represents the paragraph (\<**calcChain**\>) element defined in the Open XML File Format schema for SpreadsheetML documents. Use the **CalculationChain** class diff --git a/docs/working-with-the-shared-string-table.md b/docs/working-with-the-shared-string-table.md index cd88ae81..82a84d38 100644 --- a/docs/working-with-the-shared-string-table.md +++ b/docs/working-with-the-shared-string-table.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Working with the shared string table (Open XML SDK) -This topic discusses the Open XML SDK 2.5 [SharedStringTable](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.sharedstringtable.aspx) class and how it relates +This topic discusses the Open XML SDK [SharedStringTable](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.sharedstringtable.aspx) class and how it relates to the Open XML File Format SpreadsheetML schema. For more information about the overall structure of the parts and elements that make up a SpreadsheetML document, see [Structure of a SpreadsheetML document (Open XML SDK)](structure-of-a-spreadsheetml-document.md). @@ -68,18 +68,18 @@ workbook contains only one shared string table part that contains strings that can appear multiple times in one sheet or in multiple sheets. -The following table lists the common Open XML SDK 2.5 classes used when +The following table lists the common Open XML SDK classes used when working with the **SharedStringTable** class. -| **SpreadsheetML Element** | **Open XML SDK 2.5 Class** | +| **SpreadsheetML Element** | **Open XML SDK Class** | |---------------------------|------------------------------------------------------------------------------------------------------------------------------| | si | [SharedStringItem](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.sharedstringitem.aspx) | | t | [Text](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.text.aspx) | -------------------------------------------------------------------------------- -## Open XML SDK 2.5 SharedStringTable Class -The Open XML SDK 2.5**SharedStringTable** class +## Open XML SDK SharedStringTable Class +The Open XML SDK**SharedStringTable** class represents the paragraph (\<**sst**\>) element defined in the Open XML File Format schema for SpreadsheetML documents. Use the **SharedStringTable** class to @@ -268,7 +268,7 @@ insert text into a cell, see [How to: Insert text into a cell in a spreadsheet d ``` ### Generated SpreadsheetML -If you run the Open XML SDK 2.5 in the [How to: Insert text into a cell in a spreadsheet document (Open XML SDK)](how-to-insert-text-into-a-cell-in-a-spreadsheet.md) topic and insert +If you run the Open XML SDK in the [How to: Insert text into a cell in a spreadsheet document (Open XML SDK)](how-to-insert-text-into-a-cell-in-a-spreadsheet.md) topic and insert the word "hello" into cell A1, the following XML is written to the "sharedStrings.xml" file in the .zip file of the SpreadsheetML document referenced in the code. diff --git a/docs/working-with-wordprocessingml-tables.md b/docs/working-with-wordprocessingml-tables.md index c535d57f..fb73e060 100644 --- a/docs/working-with-wordprocessingml-tables.md +++ b/docs/working-with-wordprocessingml-tables.md @@ -16,7 +16,7 @@ ms.localizationpriority: high --- # Working with WordprocessingML tables (Open XML SDK) -This topic discusses the Open XML SDK 2.5 [Table](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.table.aspx) class and how it relates to the Office Open XML File Formats WordprocessingML schema. +This topic discusses the Open XML SDK [Table](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.table.aspx) class and how it relates to the Office Open XML File Formats WordprocessingML schema. ## Tables in WordprocessingML @@ -32,7 +32,7 @@ A tbl element has two elements that define its properties: tblPr, which defines The following table lists some of the most common Open XML SDK classes used when working with tables. -| XML element | Open XML SDK 2.5 Class | +| XML element | Open XML SDK Class | | ------------- | ------------- | | Content Cell | Content Cell | |gridCol|GridColumn| @@ -41,29 +41,29 @@ The following table lists some of the most common Open XML SDK classes used when |tc|TableCell| |tr|TableRow| -## Open XML SDK 2.5 Table Class +## Open XML SDK Table Class -The Open XML SDK 2.5 [Table](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.table.aspx) class represents the (\) element defined in the Open XML File Format schema for WordprocessingML documents as discussed above. Use a Tableobject to manipulate an individual table in a WordprocessingML document. +The Open XML SDK [Table](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.table.aspx) class represents the (\) element defined in the Open XML File Format schema for WordprocessingML documents as discussed above. Use a Tableobject to manipulate an individual table in a WordprocessingML document. ## TableProperties Class -The Open XML SDK 2.5 [TableProperties](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.tableproperties.aspx) class represents the (\) element defined in the Open XML File Format schema for WordprocessingML documents. The \ element defines table-wide properties for a table. Use a TableProperties object to set table-wide properties for a table in a WordprocessingML document. +The Open XML SDK [TableProperties](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.tableproperties.aspx) class represents the (\) element defined in the Open XML File Format schema for WordprocessingML documents. The \ element defines table-wide properties for a table. Use a TableProperties object to set table-wide properties for a table in a WordprocessingML document. ## TableGrid Class -The Open XML SDK 2.5 [TableGrid](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.tablegrid.aspx) class represents the (\) element defined in the Open XML File Format schema for WordprocessingML documents. In conjunction with grid column (\) child elements, the \ element defines the columns for a table and specifies the default width of table cells in the columns. Use a TableGrid object to define the columns in a table in a WordprocessingML document. +The Open XML SDK [TableGrid](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.tablegrid.aspx) class represents the (\) element defined in the Open XML File Format schema for WordprocessingML documents. In conjunction with grid column (\) child elements, the \ element defines the columns for a table and specifies the default width of table cells in the columns. Use a TableGrid object to define the columns in a table in a WordprocessingML document. ## GridColumn Class -The Open XML SDK 2.5 [GridColumn](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.gridcolumn.aspx) class represents the grid column (\) element defined in the Open XML File Format schema for WordprocessingML documents. The \ element is a child element of the \ element and defines a single column in a table in a WordprocessingML document. Use the GridColumn class to manipulate an individual column in a WordprocessingML document. +The Open XML SDK [GridColumn](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.gridcolumn.aspx) class represents the grid column (\) element defined in the Open XML File Format schema for WordprocessingML documents. The \ element is a child element of the \ element and defines a single column in a table in a WordprocessingML document. Use the GridColumn class to manipulate an individual column in a WordprocessingML document. ## TableRow Class -The Open XML SDK 2.5 [TableRow](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.tablerow.aspx) class represents the table row (\) element defined in the Open XML File Format schema for WordprocessingML documents. The \ element defines a row in a table in a WordprocessingML document, analogous to the \ tag in HTML. A table row can also have formatting applied to it using a table row properties (\) element. The Open XML SDK 2.5 [TableRowProperties](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.tablerowproperties.aspx) class represents the \ element. +The Open XML SDK [TableRow](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.tablerow.aspx) class represents the table row (\) element defined in the Open XML File Format schema for WordprocessingML documents. The \ element defines a row in a table in a WordprocessingML document, analogous to the \ tag in HTML. A table row can also have formatting applied to it using a table row properties (\) element. The Open XML SDK [TableRowProperties](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.tablerowproperties.aspx) class represents the \ element. ## TableCell Class -The Open XML SDK 2.5 [TableCell](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.tablecell.aspx) class represents the table cell (\) element defined in the Open XML File Format schema for WordprocessingML documents. The \ element defines a cell in a table in a WordprocessingML document, analogous to the \ tag in HTML. A table cell can also have formatting applied to it using a table cell properties (\) element. The Open XML SDK 2.5 [TableCellProperties](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.tablecellproperties.aspx) class represents the \ element. +The Open XML SDK [TableCell](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.tablecell.aspx) class represents the table cell (\) element defined in the Open XML File Format schema for WordprocessingML documents. The \ element defines a cell in a table in a WordprocessingML document, analogous to the \ tag in HTML. A table cell can also have formatting applied to it using a table cell properties (\) element. The Open XML SDK [TableCellProperties](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.tablecellproperties.aspx) class represents the \ element. ## Open XML SDK Code Example @@ -201,7 +201,7 @@ When this code is run, the following XML is written to the WordprocessingML docu ## See also -- [About the Open XML SDK 2.5 for Office](about-the-open-xml-sdk.md) +- [About the Open XML SDK for Office](about-the-open-xml-sdk.md) - [Structure of a WordprocessingML document (Open XML SDK)](structure-of-a-wordprocessingml-document.md) - [Working with paragraphs (Open XML SDK)](working-with-paragraphs.md) - [Working with runs (Open XML SDK)](working-with-runs.md)