clean up docs\spreadsheet\working-with-sheets.md

Author: mikeebowen

docs/spreadsheet/working-with-sheets.md

@@ -11,7 +11,7 @@ ms.suite: office
 ms.author: o365devx
 author: o365devx
 ms.topic: conceptual
-ms.date: 11/01/2017
+ms.date: 01/14/2025
 ms.localizationpriority: high
 ---
 # Working with sheets
@@ -25,7 +25,7 @@ SpreadsheetML document, see [Structure of a SpreadsheetML document](structure-of
 ## Sheets in SpreadsheetML
 
 The following information from the [!include[ISO/IEC 29500 URL](../includes/iso-iec-29500-link.md)]
-specification introduces the **sheet** (\<**sheet**\>) element.
+specification introduces the **sheet** (`<sheet/>`) element.
 
 Sheets are the central structures within a workbook, and are where the
 user does most of their spreadsheet work. The most common type of sheet
@@ -45,12 +45,12 @@ Other types of sheets include chart sheets and dialog sheets.
 
 ## Open XML SDK 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.
+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.
 
 The following information from the ISO/IEC 29500 specification
-introduces the **worksheet** (\<**worksheet**\>) element.
+introduces the `worksheet` (`<worksheet/>`) element.
 
 An instance of this part type contains all the data, formulas, and
 characteristics associated with a given worksheet.
@@ -83,23 +83,23 @@ when empty.
 &copy; [!include[ISO/IEC 29500 version](../includes/iso-iec-29500-version.md)]
 
 A typical spreadsheet has at least one worksheet. The worksheet contains
-a table like structure for defining data, represented by the **sheetData** element. A sheet that contains data
-uses the **worksheet** element as the root
+a table like structure for defining data, represented by the `sheetData` element. A sheet that contains data
+uses the `worksheet` element as the root
 element for defining worksheets. Inside a worksheet the data is split up
 into three distinct sections. The first section contains optional sheet
 properties. The second section contains the data, using the required
-**sheetData** element. The third section contains optional supporting
+`sheetData` element. The third section contains optional supporting
 features such as sheet protection and filter information. To define an
-empty worksheet you only have to use the **worksheet** and **sheetData** elements. The **sheetData** element can be empty.
-
-To create new values for the worksheet you define rows inside the **sheetData** element. These rows contain cells,
-which contain values. The **row** element
-defines a new row. Normally the first row in the **sheetData** is the first row in the visible sheet.
-Inside the row you create new **cells** using the \<**c**\> element. Values for cells can be provided by
-storing a \<**v**\> element inside the cell.
-Usually the \<**v**\> element contains the
+empty worksheet you only have to use the `worksheet` and `sheetData` elements. The `sheetData` element can be empty.
+
+To create new values for the worksheet you define rows inside the `sheetData` element. These rows contain cells,
+which contain values. The `row` element
+defines a new row. Normally the first row in the `sheetData` is the first row in the visible sheet.
+Inside the row you create new `cells` using the `<c/>` element. Values for cells can be provided by
+storing a `<v/>` element inside the cell.
+Usually the `<v/>` element contains the
 current value of the worksheet cell. If the value is a numeric value, it
-is stored directly in the \<**v**\> element in
+is stored directly in the `<v/>` element in
 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](working-with-the-shared-string-table.md).
@@ -109,10 +109,10 @@ working with the <xref:DocumentFormat.OpenXml.Spreadsheet.Worksheet> class.
 
 | **SpreadsheetML Element** | **Open XML SDK Class** |
 |---|---|
-| sheetData | <xref:DocumentFormat.OpenXml.Spreadsheet.SheetData> |
-| row | <xref:DocumentFormat.OpenXml.Spreadsheet.Row> |
-| c | <xref:DocumentFormat.OpenXml.Spreadsheet.Cell> |
-| v | <xref:DocumentFormat.OpenXml.Spreadsheet.CellValue> |
+| `<sheetData/>` | <xref:DocumentFormat.OpenXml.Spreadsheet.SheetData> |
+| `<row/>` | <xref:DocumentFormat.OpenXml.Spreadsheet.Row> |
+| `<c/>` | <xref:DocumentFormat.OpenXml.Spreadsheet.Cell> |
+| `<v/>` | <xref:DocumentFormat.OpenXml.Spreadsheet.CellValue> |
 
 For more information about optional spreadsheet elements, such as sheet
 properties and supporting sheet features, see the ISO/IEC 29500
@@ -121,7 +121,7 @@ specification.
 ### SheetData Class
 
 The following information from the ISO/IEC 29500 specification
-introduces the **sheet data** (\<**sheetData**\>) element.
+introduces the **sheet data** (`<sheetData/>`) element.
 
 The cell table is the core structure of a worksheet. It consists of all
 the text, numbers, and formulas in the grid.
@@ -131,7 +131,7 @@ the text, numbers, and formulas in the grid.
 ### Row Class
 
 The following information from the ISO/IEC 29500 specification
-introduces the **row** (\<**row**\>) element.
+introduces the **row** (`<row/>`) element.
 
 The cells in the cell table are organized by row. Each row has an index
 (attribute r) so that empty rows need not be written out. Each row
@@ -143,7 +143,7 @@ position in the sheet. In this example, the first row of data is row 2.
 ### Cell Class
 
 The following information from the ISO/IEC 29500 specification
-introduces the **cell** (\<**c**\>) element.
+introduces the **cell** (`<c/>`) element.
 
 The cell itself is expressed by the c collection. Each cell indicates
 its location in the grid using A1-style reference notation. A cell can
@@ -157,14 +157,14 @@ written out.
 ### CellValue Class
 
 The following information from the ISO/IEC 29500 specification
-introduces the **cell value** (\<**v**\>) element.
+introduces the **cell value** (`<v/>`) element.
 
 Cells contain values, whether the values were directly entered (e.g.,
 cell A2 in our example has the value External Link:) or are the result
 of a calculation (e.g., cell B3 in our example has the formula B2+1).
 
 String values in a cell are not stored in the cell table unless they are
-the result of a calculation. Therefore, instead of seeing External Link:
+the result of a calculation. Therefore, instead of seeing External Link
 as the content of the cell's v node, instead you see a zero-based index
 into the shared string table where that string is stored uniquely. This
 is done to optimize load/save performance and to reduce duplication of
@@ -177,15 +177,15 @@ indicates string, then it is an index and not a numeric value.
 ### Open XML SDK Code Example
 
 The following code example creates a spreadsheet document with the
-specified file name and instantiates a **Worksheet** class, and then adds a row and adds a
+specified file name and instantiates a `Worksheet` class, and then adds a row and adds a
 cell to the cell table at position A1. Then the value of the cell in A1
 is set equal to the numeric value 100.
 
 ### [C#](#tab/cs)
-[!code-csharp[](../../samples/spreadsheet/working_with_sheets/cs/Program.cs)]
+[!code-csharp[](../../samples/spreadsheet/working_with_sheets/cs/Program.cs#snippet0)]
 
 ### [Visual Basic](#tab/vb)
-[!code-vb[](../../samples/spreadsheet/working_with_sheets/vb/Program.vb)]
+[!code-vb[](../../samples/spreadsheet/working_with_sheets/vb/Program.vb#snippet0)]
 
 ### Generated SpreadsheetML
 
@@ -208,7 +208,7 @@ the "sheet.xml" file in the "worksheets" folder of the .zip file.
 ## The Open XML SDK Chartsheet Class
 
 The following information from the ISO/IEC 29500 specification
-introduces the **chartsheet** (\<**chartsheet**\>) element.
+introduces the **chartsheet** (`<chartsheet/>`) element.
 
 An instance of this part type represents a chart that is stored in its
 own sheet.
@@ -234,12 +234,12 @@ working with the <xref:DocumentFormat.OpenXml.Spreadsheet.Chartsheet> class.
 
 | **SpreadsheetML Element** | **Open XML SDK Class** |
 |---|---|
-| drawing | <xref:DocumentFormat.OpenXml.Spreadsheet.Drawing> |
+| `<drawing/>` | <xref:DocumentFormat.OpenXml.Spreadsheet.Drawing> |
 
 ### Drawing Class
 
 The following information from the ISO/IEC 29500 specification
-introduces the **drawings** (\<**wsDr**\>) element.
+introduces the **drawings** (`<wsDr/>`) element.
 
 An instance of this part type contains the presentation and layout
 information for one or more drawing elements that are present on this
@@ -256,7 +256,7 @@ be only one Drawings part per worksheet or chartsheet.
 ## Open XML SDK Dialogsheet Class
 
 The following information from the ISO/IEC 29500 specification
-introduces the **dialogsheet** (\<**dialogsheet**\>) element.
+introduces the **dialogsheet** (`<dialogsheet/>`) element.
 
 An instance of this part type contains information about a legacy custom
 dialog box for a user form.

samples/spreadsheet/working_with_sheets/cs/Program.cs

@@ -4,6 +4,7 @@
 
 CreateSpreadsheetWorkbook(args[0]);
 
+// <Snippet0>
 static void CreateSpreadsheetWorkbook(string filepath)
 {
     // Use 'using' block to ensure proper disposal of the document
@@ -52,3 +53,4 @@ static void CreateSpreadsheetWorkbook(string filepath)
         newCell.DataType = new EnumValue<CellValues>(CellValues.Number);
     }
 }
+// </Snippet0>

samples/spreadsheet/working_with_sheets/vb/Program.vb

@@ -2,53 +2,63 @@ Imports DocumentFormat.OpenXml
 Imports DocumentFormat.OpenXml.Packaging
 Imports DocumentFormat.OpenXml.Spreadsheet
 
-Module MyModule
-
+Module Program
     Sub Main(args As String())
+        CreateSpreadsheetWorkbook(args(0))
     End Sub
 
-    Public Sub CreateSpreadsheetWorkbookWithNumValue(ByVal filepath As String)
+    ' <Snippet0>
+    Sub CreateSpreadsheetWorkbook(filepath As String)
         ' Use 'Using' block to ensure proper disposal of the document
         Using spreadsheetDocument As SpreadsheetDocument = SpreadsheetDocument.Create(filepath, SpreadsheetDocumentType.Workbook)
-
             ' Add a WorkbookPart to the document.
-            Dim workbookpart As WorkbookPart = spreadsheetDocument.AddWorkbookPart()
-            workbookpart.Workbook = New Workbook()
+            Dim workbookPart As WorkbookPart = spreadsheetDocument.AddWorkbookPart()
+            workbookPart.Workbook = New Workbook()
 
             ' Add a WorksheetPart to the WorkbookPart.
-            Dim worksheetPart As WorksheetPart = workbookpart.AddNewPart(Of WorksheetPart)()
+            Dim worksheetPart As WorksheetPart = workbookPart.AddNewPart(Of WorksheetPart)()
             worksheetPart.Worksheet = New Worksheet(New SheetData())
 
             ' Add Sheets to the Workbook.
-            Dim sheets As Sheets = spreadsheetDocument.WorkbookPart.Workbook.AppendChild(Of Sheets)(New Sheets())
+            Dim sheets As Sheets = workbookPart.Workbook.AppendChild(Of Sheets)(New Sheets())
 
             ' Append a new worksheet and associate it with the workbook.
-            Dim sheet As New Sheet() With {.Id = spreadsheetDocument.WorkbookPart.GetIdOfPart(worksheetPart), .SheetId = 1, .Name = "mySheet"}
+            Dim sheet As Sheet = New Sheet() With {
+                .Id = workbookPart.GetIdOfPart(worksheetPart),
+                .SheetId = 1,
+                .Name = "mySheet"
+            }
             sheets.Append(sheet)
 
             ' Get the sheetData cell table.
-            Dim sheetData As SheetData = worksheetPart.Worksheet.GetFirstChild(Of SheetData)()
+            Dim sheetData As SheetData = If(worksheetPart.Worksheet.GetFirstChild(Of SheetData)(), worksheetPart.Worksheet.AppendChild(Of SheetData)(New SheetData()))
 
             ' Add a row to the cell table.
-            Dim row As New Row() With {.RowIndex = 1}
+            Dim row As Row = New Row() With {
+                .RowIndex = 1
+            }
             sheetData.Append(row)
 
             ' In the new row, find the column location to insert a cell in A1.  
             Dim refCell As Cell = Nothing
+
             For Each cell As Cell In row.Elements(Of Cell)()
-                If String.Compare(cell.CellReference.Value, "A1", True) > 0 Then
+                If String.Compare(cell.CellReference?.Value, "A1", True) > 0 Then
                     refCell = cell
                     Exit For
                 End If
             Next
 
             ' Add the cell to the cell table at A1.
-            Dim newCell As New Cell() With {.CellReference = "A1"}
+            Dim newCell As Cell = New Cell() With {
+                .CellReference = "A1"
+            }
             row.InsertBefore(newCell, refCell)
 
             ' Set the cell value to be a numeric value of 100.
             newCell.CellValue = New CellValue("100")
             newCell.DataType = New EnumValue(Of CellValues)(CellValues.Number)
         End Using
     End Sub
+    ' </Snippet0>
 End Module