Extract snippets

docs/general/how-to-add-a-new-document-part-to-a-package.md

@@ -40,8 +40,7 @@ The code starts with opening a package file by passing a file name to one of the
 ***
 
 
-The **using** statement provides a recommended alternative to the typical .Create, .Save, .Close sequence. It ensures that the **Dispose** method (internal method used by the Open XML SDK to clean up resources) is automatically called when the closing brace is reached. The block that follows the **using** statement establishes a scope for the object that is created or named in the **using** statement, in this case **wordDoc**. Because the <xref:DocumentFormat.OpenXml.Packaging.WordprocessingDocument> class in the Open XML SDK
-automatically saves and closes the object as part of its **System.IDisposable** implementation, and because the **Dispose** method is automatically called when you exit the block; you do not have to explicitly call **Save** and **Close**, as long as you use **using**.
+[!include[Using Statement](../includes/using-statement.md)]
 
 [!include[Structure](../includes/word/structure.md)]
 

docs/general/how-to-copy-the-contents-of-an-open-xml-package-part-to-a-document-part-in-a-dif.md

@@ -33,7 +33,7 @@ programmatically.
 To open an existing document, instantiate the <xref:DocumentFormat.OpenXml.Packaging.WordprocessingDocument> class as shown in
 the following two **using** statements. In the
 same statement, you open the word processing file with the specified
-file name by using the [Open](/dotnet/api/documentformat.openxml.packaging.wordprocessingdocument.open) method, with the Boolean parameter.
+file name by using the <xref:DocumentFormat.OpenXml.Packaging.WordprocessingDocument.Open%2A> method, with the Boolean parameter.
 For the source file that set the parameter to **false** to open it for read-only access. For the
 target file, set the parameter to **true** in
 order to enable editing the document.
@@ -57,16 +57,7 @@ order to enable editing the document.
 ```
 ***
 
-The `using` statement provides a recommended
-alternative to the typical .Create, .Save, .Close sequence. It ensures
-that the <xref:System.IDisposable.Dispose> method (internal method
-used by the Open XML SDK to clean up resources) is automatically called
-when the closing brace is reached. The block that follows the using
-statement establishes a scope for the object that is created or named in
-the `using` statement. Because the <xref:DocumentFormat.OpenXml.Packaging.WordprocessingDocument> class in the Open XML SDK
-automatically saves and closes the object as part of its <xref:System.IDisposable> implementation, and because
-<xref:System.IDisposable.Dispose> is automatically called when you
-exit the block, you do not have to explicitly call <xref:DocumentFormat.OpenXml.Packaging.OpenXmlPackage.Save%2A>.
+[!include[Using Statement](../includes/using-statement.md)]
 
 --------------------------------------------------------------------------------
 

docs/general/how-to-create-a-package.md

@@ -59,15 +59,7 @@ template.
 ```
 ***
 
-The **using** statement provides a recommended
-alternative to the typical .Create, .Save, .Close sequence. It ensures
-that the **Dispose** () method (internal method
-used by the Open XML SDK to clean up resources) is automatically called
-when the closing bracket is reached. The block that follows the **using** statement establishes a scope for the
-object that is created or named in the **using** statement, in this case **wordDoc**. Because the <xref:DocumentFormat.OpenXml.Packaging.WordprocessingDocument> class in the Open XML SDK
-automatically saves and closes the object as part of its **System.IDisposable** implementation, and because
-**Dispose** is automatically called when you exit the bracketed block, you do not have to explicitly call **Save** and **Close**─as
-long as you use **using**.
+[!include[Using Statement](../includes/using-statement.md)]
 
 Once you have created the Word document package, you can add parts to
 it. To add the main document part you call <xref:DocumentFormat.OpenXml.Packaging.WordprocessingDocument.AddMainDocumentPart%2A>. Having done that,

docs/general/how-to-get-the-contents-of-a-document-part-from-a-package.md

@@ -54,17 +54,7 @@ opened in read-only mode to avoid accidental changes.
 ```
 ***
 
-
-The **using** statement provides a recommended
-alternative to the typical .Create, .Save, .Close sequence. It ensures
-that the **Dispose** method (internal method
-used by the Open XML SDK to clean up resources) is automatically called
-when the closing brace is reached. The block that follows the **using** statement establishes a scope for the
-object that is created or named in the **using** statement, in this case **wordDoc**. Because the <xref:DocumentFormat.OpenXml.Packaging.WordprocessingDocument> class in the Open XML SDK
-automatically saves and closes the object as part of its **System.IDisposable** implementation, and because
-the **Dispose** method is automatically called
-when you exit the block; you do not have to explicitly call **Save** and **Close**─as
-long as you use using.
+[!include[Using Statement](../includes/using-statement.md)]
 
 
 ---------------------------------------------------------------------------------

docs/general/how-to-remove-a-document-part-from-a-package.md

@@ -54,16 +54,7 @@ should be opened in read/write mode.
 ***
 
 
-The **using** statement provides a recommended
-alternative to the typical .Create, .Save, .Close sequence. It ensures
-that the **Dispose** method (internal method
-used by the Open XML SDK to clean up resources) is automatically called
-when the closing brace is reached. The block that follows the **using** statement establishes a scope for the
-object that is created or named in the **using** statement, in this case **wordDoc**. Because the <xref:DocumentFormat.OpenXml.Packaging.WordprocessingDocument> class in the Open XML SDK
-automatically saves and closes the object as part of its **System.IDisposable** implementation, and because
-the **Dispose** method is automatically called
-when you exit the block; you do not have to explicitly call **Save** and **Close**─as
-long as you use **using**.
+[!include[Using Statement](../includes/using-statement.md)]
 
 
 ---------------------------------------------------------------------------------

docs/general/how-to-replace-the-theme-part-in-a-word-processing-document.md

@@ -29,7 +29,7 @@ In the sample code, you start by opening the word processing file by
 instantiating the <xref:DocumentFormat.OpenXml.Packaging.WordprocessingDocument> class as shown in
 the following **using** statement. In the same
 statement, you open the word processing file *document* by using the
-[Open](/dotnet/api/documentformat.openxml.packaging.wordprocessingdocument.open) method, with the Boolean parameter set
+<xref:DocumentFormat.OpenXml.Packaging.WordprocessingDocument.Open%2A> method, with the Boolean parameter set
 to **true** to enable editing the document.
 
 ### [C#](#tab/cs-0)
@@ -49,19 +49,7 @@ to **true** to enable editing the document.
 ```
 ***
 
-
-The **using** statement provides a recommended
-alternative to the typical .Open, .Save, .Close sequence. It ensures
-that the **Dispose** method (internal method
-used by the Open XML SDK to clean up resources) is automatically called
-when the closing brace is reached. The block that follows the **using** statement establishes a scope for the
-object that is created or named in the **using** statement, in this case *wordDoc*. Because
-the <xref:DocumentFormat.OpenXml.Packaging.WordprocessingDocument> class in the
-Open XML SDK automatically saves and closes the object as part of its
-**System.IDisposable** implementation, and
-because **Dispose** is automatically called
-when you exit the block, you do not have to explicitly call **Save** and **Close**─as
-long as you use **using**.
+[!include[Using Statement](../includes/using-statement.md)]
 
 
 ## How to Change Theme in a Word Package

docs/general/how-to-search-and-replace-text-in-a-document-part.md

@@ -32,7 +32,7 @@ In the sample code, you start by opening the word processing file by
 instantiating the **<xref:DocumentFormat.OpenXml.Packaging.WordprocessingDocument>** class as shown in
 the following **using** statement. In the same
 statement, you open the word processing file *document* by using the
-**[Open](/dotnet/api/documentformat.openxml.packaging.wordprocessingdocument.open)** method, with the Boolean parameter set
+**<xref:DocumentFormat.OpenXml.Packaging.WordprocessingDocument.Open%2A>** method, with the Boolean parameter set
 to **true** to enable editing the document.
 
 ### [C#](#tab/cs-0)
@@ -53,18 +53,7 @@ to **true** to enable editing the document.
 ***
 
 
-The **using** statement provides a recommended
-alternative to the typical .Open, .Save, .Close sequence. It ensures
-that the **Dispose** method (internal method
-used by the Open XML SDK to clean up resources) is automatically called
-when the closing brace is reached. The block that follows the **using** statement establishes a scope for the
-object that is created or named in the **using** statement, in this case *wordDoc*. Because
-the <xref:DocumentFormat.OpenXml.Packaging.WordprocessingDocument> class in the
-Open XML SDK automatically saves and closes the object as part of its
-**System.IDisposable** implementation, and
-because **Dispose** is automatically called
-when you exit the block, you do not have to explicitly call **Save** and **Close**─as
-long as you use **using**.
+[!include[Using Statement](../includes/using-statement.md)]
 
 
 --------------------------------------------------------------------------------

docs/includes/using-statement.md

@@ -0,0 +1,11 @@
+The `using` statement provides a recommended
+alternative to the typical .Create, .Save, .Close sequence. It ensures
+that the <xref:System.IDisposable.Dispose> method (internal method
+used by the Open XML SDK to clean up resources) is automatically called
+when the closing brace is reached. The block that follows the using
+statement establishes a scope for the object that is created or named in
+the using statement. Because the <xref:DocumentFormat.OpenXml.Packaging.WordprocessingDocument> class in the Open XML SDK
+automatically saves and closes the object as part of its <xref:System.IDisposable> implementation, and because
+<xref:System.IDisposable.Dispose> is automatically called when you
+exit the block, you do not have to explicitly call <xref:DocumentFormat.OpenXml.Packaging.OpenXmlPackage.Save> and
+<xref:DocumentFormat.OpenXml.Packaging.OpenXmlPackage.Close> as long as you use `using`.

docs/presentation/how-to-apply-a-theme-to-a-presentation.md

@@ -51,12 +51,7 @@ represents the path for the target presentation document.
 ***
 
 
-The **using** statement provides a recommended
-alternative to the typical .Open, .Save, .Close sequence. It ensures
-that the **Dispose** method (internal method
-used by the Open XML SDK to clean up resources) is automatically called
-when the closing brace is reached. The block that follows the **using** statement establishes a scope for the
-object that is created or named in the **using** statement, in this case **themeDocument** and **presentationDocument**.
+[!include[Using Statement](../includes/using-statement.md)]
 
 
 -----------------------------------------------------------------------------

docs/presentation/how-to-change-the-fill-color-of-a-shape-in-a-presentation.md

@@ -53,12 +53,7 @@ you want to open the document.
 ***
 
 
-The **using** statement provides a recommended
-alternative to the typical .Open, .Save, .Close sequence. It ensures
-that the **Dispose** method (internal method
-used by the Open XML SDK to clean up resources) is automatically called
-when the closing brace is reached. The block that follows the **using** statement establishes a scope for the
-object that is created or named in the **using** statement, in this case *ppt*.
+[!include[Using Statement](../includes/using-statement.md)]
 
 
 ## The Structure of the Shape Tree 

docs/presentation/how-to-delete-a-slide-from-a-presentation.md

@@ -76,7 +76,7 @@ statement.
 ***
 
 
-The **using** statement provides a recommended alternative to the typical .Open, .Save, .Close sequence. It ensures that the **Dispose** method (internal method used by the Open XML SDK to clean up resources) is automatically called when the closing brace is reached. The block that follows the **using** statement establishes a scope for the object that is created or named in the **using** statement, in this case **presentationDocument**.
+[!include[Using Statement](../includes/using-statement.md)]
 
 [!include[Structure](../includes/presentation/structure.md)]
 

docs/presentation/how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentatio.md

@@ -59,12 +59,7 @@ Options.
 ***
 
 
-The **using** statement provides a recommended
-alternative to the typical .Open, .Save, .Close sequence. It ensures
-that the **Dispose** method (internal method
-used by the Open XML SDK to clean up resources) is automatically called
-when the closing brace is reached. The block that follows the **using** statement establishes a scope for the
-object that is created or named in the **using** statement, in this case *doc*.
+[!include[Using Statement](../includes/using-statement.md)]
 
 [!include[Structure](../includes/presentation/structure.md)]
 

docs/presentation/how-to-get-all-the-external-hyperlinks-in-a-presentation.md

@@ -58,12 +58,7 @@ path for the file from which you want to open the document.
 ***
 
 
-The **using** statement provides a recommended
-alternative to the typical .Open, .Save, .Close sequence. It ensures
-that the **Dispose** method (internal method
-used by the Open XML SDK to clean up resources) is automatically called
-when the closing brace is reached. The block that follows the **using** statement establishes a scope for the
-object that is created or named in the **using** statement, in this case **document**.
+[!include[Using Statement](../includes/using-statement.md)]
 
 
 --------------------------------------------------------------------------------

docs/presentation/how-to-get-all-the-text-in-a-slide-in-a-presentation.md

@@ -56,12 +56,7 @@ document.
 ***
 
 
-The **using** statement provides a recommended
-alternative to the typical .Open, .Save, .Close sequence. It ensures
-that the **Dispose** method (internal method
-used by the Open XML SDK to clean up resources) is automatically called
-when the closing brace is reached. The block that follows the **using** statement establishes a scope for the
-object that is created or named in the **using** statement, in this case **presentationDocument**.
+[!include[Using Statement](../includes/using-statement.md)]
 
 
 --------------------------------------------------------------------------------

docs/presentation/how-to-get-all-the-text-in-all-slides-in-a-presentation.md

@@ -56,12 +56,7 @@ document.
 ***
 
 
-The **using** statement provides a recommended
-alternative to the typical .Open, .Save, .Close sequence. It ensures
-that the **Dispose** method (internal method
-used by the Open XML SDK to clean up resources) is automatically called
-when the closing brace is reached. The block that follows the **using** statement establishes a scope for the
-object that is created or named in the **using** statement, in this case **presentationDocument**.
+[!include[Using Statement](../includes/using-statement.md)]
 
 
 --------------------------------------------------------------------------------

docs/presentation/how-to-get-the-titles-of-all-the-slides-in-a-presentation.md

@@ -55,14 +55,7 @@ document.
 ```
 ***
 
-
-The **using** statement provides a recommended
-alternative to the typical .Open, .Save, .Close sequence. It ensures
-that the **Dispose** method (internal method
-used by the Open XML SDK to clean up resources) is automatically called
-when the closing brace is reached. The block that follows the **using** statement establishes a scope for the
-object that is created or named in the **using** statement, in this case
-*presentationDocument*.
+[!include[Using Statement](../includes/using-statement.md)]
 
 [!include[Structure](../includes/presentation/structure.md)]
 

docs/presentation/how-to-insert-a-new-slide-into-a-presentation.md

@@ -51,14 +51,7 @@ document.
 ```
 ***
 
-
-The **using** statement provides a recommended
-alternative to the typical .Open, .Save, .Close sequence. It ensures
-that the **Dispose** method (internal method
-used by the Open XML SDK to clean up resources) is automatically called
-when the closing brace is reached. The block that follows the **using** statement establishes a scope for the
-object that is created or named in the **using** statement, in this case
-*presentationDocument*.
+[!include[Using Statement](../includes/using-statement.md)]
 
 [!include[Structure](../includes/presentation/structure.md)]
 

docs/presentation/how-to-move-a-paragraph-from-one-presentation-to-another.md

@@ -52,13 +52,7 @@ for the file from which you want to open the document.
 ```
 ***
 
-
-The **using** statement provides a recommended
-alternative to the typical .Open, .Save, .Close sequence. It ensures
-that the **Dispose** method (internal method
-used by the Open XML SDK to clean up resources) is automatically called
-when the closing brace is reached. The block that follows the **using** statement establishes a scope for the
-object that is created or named in the **using** statement, in this case *doc*.
+[!include[Using Statement](../includes/using-statement.md)]
 
 [!include[Structure](../includes/presentation/structure.md)]
 

docs/presentation/how-to-move-a-slide-to-a-new-position-in-a-presentation.md

@@ -57,13 +57,7 @@ open the document.
 ```
 ***
 
-
-The **using** statement provides a recommended
-alternative to the typical .Open, .Save, .Close sequence. It ensures
-that the **Dispose** method (internal method
-used by the Open XML SDK to clean up resources) is automatically called
-when the closing brace is reached. The block that follows the **using** statement establishes a scope for the
-object that is created or named in the **using** statement, in this case **presentationDocument**.
+[!include[Using Statement](../includes/using-statement.md)]
 
 
 --------------------------------------------------------------------------------