Skip to content

Commit

Permalink
Merge pull request #158 from twsouthwick/tasou/remove-2.5
Browse files Browse the repository at this point in the history
Remove explicit version reference to 2.5
  • Loading branch information
lindalu-MSFT authored Oct 17, 2023
2 parents af42b5e + 50be13d commit 889742b
Show file tree
Hide file tree
Showing 99 changed files with 477 additions and 483 deletions.
22 changes: 10 additions & 12 deletions docs/about-the-open-xml-sdk.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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.

Expand Down Expand Up @@ -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).
8 changes: 4 additions & 4 deletions docs/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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**
Expand Down
3 changes: 1 addition & 2 deletions docs/how-do-i.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)]

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -71,9 +71,9 @@ The basic document structure of a **WordProcessingML** document consists of the
</w: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 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. |
Expand Down Expand Up @@ -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)
8 changes: 4 additions & 4 deletions docs/how-to-add-a-comment-to-a-slide-in-a-presentation.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -138,13 +138,13 @@ two slides denoted by the IDs 267 and 256.
</p:presentation>
```

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. |
Expand Down Expand Up @@ -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)

Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -77,13 +77,13 @@ markup for a document that contains the text "Example text."
</w:document>
```

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. |
Expand Down Expand Up @@ -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)



8 changes: 4 additions & 4 deletions docs/how-to-add-a-new-document-part-to-a-package.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -69,9 +69,9 @@ The basic document structure of a **WordProcessingML** document consists of the
</w:document>
```

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. |
Expand Down Expand Up @@ -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)
Loading

0 comments on commit 889742b

Please sign in to comment.