Cell 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
细胞。
此类在 Office 2007 及更高版本中提供。
当对象序列化为 xml 时,其限定名称为 x:c。
public class Cell : DocumentFormat.OpenXml.Spreadsheet.CellType
	[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(22, "c")]
public class Cell : DocumentFormat.OpenXml.Spreadsheet.CellType
	[DocumentFormat.OpenXml.SchemaAttr(22, "c")]
public class Cell : DocumentFormat.OpenXml.Spreadsheet.CellType
	[DocumentFormat.OpenXml.SchemaAttr("x:c")]
public class Cell : DocumentFormat.OpenXml.Spreadsheet.CellType
	[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class Cell : DocumentFormat.OpenXml.Spreadsheet.CellType
	type Cell = class
    inherit CellType
	[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(22, "c")>]
type Cell = class
    inherit CellType
	[<DocumentFormat.OpenXml.SchemaAttr(22, "c")>]
type Cell = class
    inherit CellType
	[<DocumentFormat.OpenXml.SchemaAttr("x:c")>]
type Cell = class
    inherit CellType
	[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type Cell = class
    inherit CellType
	Public Class Cell
Inherits CellType
		- 继承
 
- 继承
 
- 属性
 
示例
下面的代码示例创建一个新工作簿,在工作簿中插入工作表,并在指定的单元格地址中写入单词“Microsoft”。
using System;  
using DocumentFormat.OpenXml;  
using DocumentFormat.OpenXml.Packaging;  
using DocumentFormat.OpenXml.Spreadsheet;  
namespace CellEx  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            // Create a spreadsheet document by providing a file name.  
            string fileName = @"C:\Users\Public\Documents\myCellEx.xlsx";  
            SpreadsheetDocument spreadsheetDocument = SpreadsheetDocument.  
                Create(fileName, SpreadsheetDocumentType.Workbook);  
            // Add a WorkbookPart to the document.  
            WorkbookPart workbookpart = spreadsheetDocument.AddWorkbookPart();  
            workbookpart.Workbook = new Workbook();  
            // Add a WorksheetPart to the WorkbookPart.  
            WorksheetPart worksheetPart = workbookpart.AddNewPart<WorksheetPart>();  
            worksheetPart.Worksheet = new Worksheet(new SheetData());  
            // Add Sheets to the Workbook.  
            Sheets sheets = spreadsheetDocument.WorkbookPart.Workbook.AppendChild<Sheets>(new Sheets());  
            // Append a new worksheet and associate it with the workbook.  
            Sheet sheet = new Sheet()  
            {   Id = spreadsheetDocument.WorkbookPart.GetIdOfPart(worksheetPart),  
                SheetId = 1, Name = "mySheet"  
            };  
            sheets.Append(sheet);  
            Worksheet worksheet = new Worksheet();  
            SheetData sheetData = new SheetData();  
            Row row = new Row();  
            Cell cell = new Cell()   
                { CellReference = "A1", DataType = CellValues.String,  
                    CellValue = new CellValue("Microsoft") };  
            row.Append(cell);  
            sheetData.Append(row);  
            worksheet.Append(sheetData);  
            worksheetPart.Worksheet = worksheet;  
            // Close the document.  
            spreadsheetDocument.Close();  
            Console.WriteLine("All done. Press any key.");  
            Console.ReadKey();  
        }  
    }       
}  
Imports DocumentFormat.OpenXml  
Imports DocumentFormat.OpenXml.Packaging  
Imports DocumentFormat.OpenXml.Spreadsheet  
Module Module1  
    Sub Main()  
        ' Create a spreadsheet document by providing a file name.  
        Dim fileName As String = "C:\Users\Public\Documents\myCellEx.xlsx"  
        Dim spreadsheetDocument As SpreadsheetDocument = _  
            spreadsheetDocument.Create(fileName, SpreadsheetDocumentType.Workbook)  
        ' Add a WorkbookPart to the document.  
        Dim workbookpart As WorkbookPart = spreadsheetDocument.AddWorkbookPart()  
        workbookpart.Workbook = New Workbook()  
        ' Add a WorksheetPart to the WorkbookPart.  
        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())  
        ' 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"}  
        sheets.Append(Sheet)  
        Dim worksheet As New Worksheet()  
        Dim sheetData As New SheetData()  
        Dim row As New Row()  
        Dim cell As New Cell() With {.CellReference = "A1", .DataType = CellValues.[String], _  
         .CellValue = New CellValue("Microsoft")}  
        row.Append(Cell)  
        sheetData.Append(row)  
        worksheet.Append(sheetData)  
        worksheetPart.Worksheet = worksheet  
        ' Close the document.  
        spreadsheetDocument.Close()  
        Console.WriteLine("All done. Press any key.")  
        Console.ReadKey()  
    End Sub  
End Module  
	注解
[ISO/IEC 29500-1 第 1 版]
c (单元格)
此集合表示工作表中的单元格。 此处表示了有关单元格的位置(引用)、值、数据类型、格式设置和公式的信息。
[示例:此示例显示网格中地址为 C6、样式索引为“6”且值元数据索引为“15”的单元格存储的信息。 该单元格包含公式和该公式的已计算结果。
<c r="C6" s="1" vm="15">  
  <f>CUBEVALUE("xlextdat9 Adventure Works",C$5,$A6)</f>  
  <v>2838512.355</v>  
</c>  
示例结束]
虽然单元格可以具有公式元素 f 和值元素 v,但当单元格的类型 t 为 inlineStr 时,仅允许该元素作为子元素。
[示例:
下面是在单元格中表达字符串而不是使用共享字符串表的示例。
<row r="1" spans="1:1">  
  <c r="A1" t="inlineStr">  
    <is><t>This is inline string example</t></is>  
  </c>  
</row>  
示例结束]
| 父元素 | 
|---|
| row (§18.3.1.73) | 
| 子元素 | 第 | 
|---|---|
| extLst (Future Feature Data Storage Area) | §18.2.10 | 
| f (公式) | §18.3.1.40 | 
| 是 (格式文本内联) | §18.3.1.53 | 
| v (单元格值) | §18.3.1.96 | 
| 属性 | 说明 | 
|---|---|
| cm (单元格元数据索引) | 与此单元格关联的单元格元数据记录的从零开始的索引。 元数据信息位于元数据部件中。 单元格元数据是存储在单元格级别的额外信息, (通过移动、复制/粘贴、清除等) 传输,附加到单元格。 无法通过公式引用访问单元格元数据。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。  | 
| ph (显示拼音) | 一个布尔值,指示电子表格应用程序是否应显示拼音信息。  拼音信息显示在单元格顶部的同一单元格中,并充当“提示”,指示文本的发音方式。  这仅适用于东亚语言。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。  | 
| r (参考) | 对此单元格位置的 A1 样式引用 此属性的可能值由 ST_CellRef 简单类型 (§18.18.7) 定义。  | 
| s (样式索引) | 此单元格样式的索引。 样式记录存储在样式部件中。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。  | 
| t (单元格数据类型) | 表示单元格数据类型的枚举。 此属性的可能值由 ) ( §18.18.11 ST_CellType简单类型定义。  | 
| vm (值元数据索引) | 与此单元格的值关联的值元数据记录的从零开始的索引。 元数据记录存储在元数据部件中。 值元数据是在单元格级别存储的额外信息,但与值而不是单元格本身相关联。 值元数据可通过公式引用进行访问。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。  | 
[注意:此元素的内容模型 (CT_Cell) 的 W3C XML 架构定义位于 §A.2 中。 注释结束]
ISO/IEC29500:2008。
构造函数
| Cell() | 
		 初始化 Cell 类的新实例。  | 
        	
| Cell(IEnumerable<OpenXmlElement>) | 
		 使用指定的子元素初始化 Cell 类的新实例。  | 
        	
| Cell(OpenXmlElement[]) | 
		 使用指定的子元素初始化 Cell 类的新实例。  | 
        	
| Cell(String) | 
		 从外部 XML 初始化 Cell 类的新实例。  | 
        	
属性
| CellFormula | 
		 公式。 表示架构中的以下元素标记:x:f。 (继承自 CellType) | 
        	
| CellMetaIndex | 
		 单元格元数据索引 表示架构中的以下属性:cm (继承自 CellType) | 
        	
| CellReference | 
		 参考 表示架构中的以下属性: r (继承自 CellType) | 
        	
| CellValue | 
		 单元格值。 表示架构中的以下元素标记:x:v。 (继承自 CellType) | 
        	
| ChildElements | 
		 获取当前元素的所有子节点。 (继承自 OpenXmlElement) | 
        	
| DataType | 
		 单元格数据类型 表示架构中的以下属性: t (继承自 CellType) | 
        	
| ExtendedAttributes | 
		 获取当前元素的架构) 中未定义的所有扩展属性 (属性。 (继承自 OpenXmlElement) | 
        	
| ExtensionList | 
		 未来特征数据存储区域。 表示架构中的以下元素标记:x:extLst。 (继承自 CellType) | 
        	
| Features | 
		 IFeatureCollection获取当前元素的 。 此功能集合将是只读的,但会从其父部件和包继承功能(如果可用)。 (继承自 OpenXmlElement) | 
        	
| FirstChild | 
		 获取当前 OpenXmlElement 元素的第一个子元素。 (继承自 OpenXmlCompositeElement) | 
        	
| HasAttributes | 
		 获取一个值,该值指示当前元素是否具有任何属性。 (继承自 OpenXmlElement) | 
        	
| HasChildren | 
		 获取一个值,该值指示当前元素是否具有任何子元素。 (继承自 OpenXmlCompositeElement) | 
        	
| InlineString | 
		 格式文本内联。 表示架构中的以下元素标记:x:is。 (继承自 CellType) | 
        	
| InnerText | 
		 获取或设置当前节点及其所有子节点的串联值。 (继承自 OpenXmlCompositeElement) | 
        	
| InnerXml | 
		 获取或设置仅表示当前节点的子节点的标记。 (继承自 OpenXmlCompositeElement) | 
        	
| LastChild | 
		 获取当前 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素,则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlCompositeElement) | 
        	
| LocalName | 
		 细胞。 此类在 Office 2007 及更高版本中提供。 当对象序列化为 xml 时,其限定名称为 x:c。  | 
        	
| LocalName | 
		 获取当前元素的本地名称。 (继承自 OpenXmlElement) | 
        	
| MCAttributes | 
		 获取或设置标记兼容性属性。 如果未为当前元素定义标记兼容性属性,则返回 null。 (继承自 OpenXmlElement) | 
        	
| NamespaceDeclarations | 
		 获取在当前元素中定义的所有命名空间声明。 如果没有命名空间声明,则返回空枚举器。 (继承自 OpenXmlElement) | 
        	
| NamespaceUri | 
		 获取当前元素的命名空间 URI。 (继承自 OpenXmlElement) | 
        	
| OpenXmlElementContext | 
		 获取当前元素的 OpenXmlElementContext。 (继承自 OpenXmlElement) | 
        	
| OuterXml | 
		 获取表示当前元素及其所有子元素的标记。 (继承自 OpenXmlElement) | 
        	
| Parent | 
		 获取当前元素的父元素。 (继承自 OpenXmlElement) | 
        	
| Prefix | 
		 获取当前元素的命名空间前缀。 (继承自 OpenXmlElement) | 
        	
| ShowPhonetic | 
		 显示拼音 表示架构中的以下属性: ph (继承自 CellType) | 
        	
| StyleIndex | 
		 样式索引 表示架构中的以下属性: (继承自 CellType) | 
        	
| ValueMetaIndex | 
		 值元数据索引 表示架构中的以下属性: vm (继承自 CellType) | 
        	
| XmlQualifiedName | 
		 获取当前元素的限定名称。 (继承自 OpenXmlElement) | 
        	
| XName | 
		 获取当前元素的限定名称。 (继承自 OpenXmlElement) | 
        	
方法
| AddAnnotation(Object) | 
		 将 对象添加到当前 OpenXmlElement 元素的批注列表中。 (继承自 OpenXmlElement) | 
        	
| AddChild(OpenXmlElement, Boolean) | 
		 如果指定元素是已知的子元素,则将其添加到 元素。 这会根据架构将 元素添加到正确的位置。 (继承自 OpenXmlCompositeElement) | 
        	
| AddNamespaceDeclaration(String, String) | 
		 将命名空间声明添加到当前节点。 (继承自 OpenXmlElement) | 
        	
| Ancestors() | 
		 枚举当前元素的所有上级。 (继承自 OpenXmlElement) | 
        	
| Ancestors<T>() | 
		 仅枚举具有指定类型的当前元素的上级。 (继承自 OpenXmlElement) | 
        	
| Annotation(Type) | 
		 从当前 OpenXmlElement 元素获取指定类型的第一个批注对象。 (继承自 OpenXmlElement) | 
        	
| Annotation<T>() | 
		 从当前 OpenXmlElement 元素获取指定类型的第一个批注对象。 (继承自 OpenXmlElement) | 
        	
| Annotations(Type) | 
		 获取具有当前 OpenXmlElement 元素的指定类型的批注的集合。 (继承自 OpenXmlElement) | 
        	
| Annotations<T>() | 
		 获取具有当前 OpenXmlElement 元素的指定类型的批注的集合。 (继承自 OpenXmlElement) | 
        	
| Append(IEnumerable<OpenXmlElement>) | 
		 将元素列表中的每个元素追加到当前元素的子元素列表的末尾。 (继承自 OpenXmlElement) | 
        	
| Append(OpenXmlElement[]) | 
		 将元素数组中的每个元素追加到当前元素的子元素列表的末尾。 (继承自 OpenXmlElement) | 
        	
| AppendChild<T>(T) | 
		 将指定的元素追加到当前元素的子节点列表的末尾。 (继承自 OpenXmlCompositeElement) | 
        	
| ClearAllAttributes() | 
		 清除所有属性,包括已知属性和扩展属性。 (继承自 OpenXmlElement) | 
        	
| Clone() | 
		 创建当前节点的副本。 (继承自 OpenXmlElement) | 
        	
| CloneNode(Boolean) | 
		 创建此节点的重复项。  | 
        	
| Descendants() | 
		 枚举当前元素的所有后代。 (继承自 OpenXmlElement) | 
        	
| Descendants<T>() | 
		 枚举类型为 T 的当前元素的所有后代。 (继承自 OpenXmlElement) | 
        	
| Elements() | 
		 枚举当前元素的所有子元素。 (继承自 OpenXmlElement) | 
        	
| Elements<T>() | 
		 仅枚举具有指定类型的当前元素的子元素。 (继承自 OpenXmlElement) | 
        	
| ElementsAfter() | 
		 枚举与当前元素相同的父级的所有同级元素。 (继承自 OpenXmlElement) | 
        	
| ElementsBefore() | 
		 枚举当前元素之前且具有与当前元素相同的父级的所有同级元素。 (继承自 OpenXmlElement) | 
        	
| GetAttribute(String, String) | 
		 获取具有指定标记名称和命名空间 URI 的 Open XML 属性。 (继承自 OpenXmlElement) | 
        	
| GetAttributes() | 
		 获取一个列表,该列表包含所有属性的副本。 (继承自 OpenXmlElement) | 
        	
| GetEnumerator() | 
		 返回循环访问子集合的枚举器。 (继承自 OpenXmlElement) | 
        	
| GetFirstChild<T>() | 
		 查找类型 T 中的第一个子元素。 (继承自 OpenXmlElement) | 
        	
| InsertAfter<T>(T, OpenXmlElement) | 
		 在指定的引用元素之后立即插入指定的元素。 (继承自 OpenXmlCompositeElement) | 
        	
| InsertAfterSelf<T>(T) | 
		 在当前元素之后立即插入指定的元素。 (继承自 OpenXmlElement) | 
        	
| InsertAt<T>(T, Int32) | 
		 在当前元素的子元素的指定索引处插入指定的元素。 (继承自 OpenXmlCompositeElement) | 
        	
| InsertBefore<T>(T, OpenXmlElement) | 
		 将指定的元素紧接在指定的引用元素之前。 (继承自 OpenXmlCompositeElement) | 
        	
| InsertBeforeSelf<T>(T) | 
		 将指定的元素紧接在当前元素的前面。 (继承自 OpenXmlElement) | 
        	
| IsAfter(OpenXmlElement) | 
		 确定当前元素是否以文档顺序显示在指定元素之后。 (继承自 OpenXmlElement) | 
        	
| IsBefore(OpenXmlElement) | 
		 确定当前元素是否按文档顺序显示在指定元素之前。 (继承自 OpenXmlElement) | 
        	
| LookupNamespace(String) | 
		 解析当前节点上下文中的命名空间前缀。 (继承自 OpenXmlElement) | 
        	
| LookupPrefix(String) | 
		 查找当前元素范围内命名空间 URI 的相应前缀。 (继承自 OpenXmlElement) | 
        	
| NextSibling() | 
		 获取紧跟在当前 OpenXmlElement 元素后面的 OpenXmlElement 元素。 如果没有下一个 OpenXmlElement 元素,则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement) | 
        	
| NextSibling<T>() | 
		 获取具有当前 OpenXmlElement 元素后面的指定类型的 OpenXmlElement 元素。 如果没有下一个 OpenXmlElement,则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement) | 
        	
| PrependChild<T>(T) | 
		 在当前元素的子节点列表的开头插入指定的元素。 (继承自 OpenXmlCompositeElement) | 
        	
| PreviousSibling() | 
		 获取紧接在当前 OpenXmlElement 元素之前的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素,则返回 null (Visual Basic ) 中 Nothing。 (继承自 OpenXmlElement) | 
        	
| PreviousSibling<T>() | 
		 获取位于当前 OpenXmlElement 之前的指定类型的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素,则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement) | 
        	
| Remove() | 
		 从其父元素中删除当前元素。 (继承自 OpenXmlElement) | 
        	
| RemoveAllChildren() | 
		 删除当前元素的所有子元素。 (继承自 OpenXmlCompositeElement) | 
        	
| RemoveAllChildren<T>() | 
		 删除类型为 T 的当前元素的所有子元素。 (继承自 OpenXmlElement) | 
        	
| RemoveAnnotations(Type) | 
		 从当前 OpenXmlElement 元素中删除指定类型的注释。 (继承自 OpenXmlElement) | 
        	
| RemoveAnnotations<T>() | 
		 从当前 OpenXmlElement 元素中删除具有指定类型的批注。 (继承自 OpenXmlElement) | 
        	
| RemoveAttribute(String, String) | 
		 从当前元素中删除 属性。 (继承自 OpenXmlElement) | 
        	
| RemoveChild<T>(T) | 
		 删除指定的子元素。 (继承自 OpenXmlCompositeElement) | 
        	
| RemoveNamespaceDeclaration(String) | 
		 删除指定前缀的命名空间声明。 如果没有前缀,则不删除任何内容。 (继承自 OpenXmlElement) | 
        	
| ReplaceChild<T>(OpenXmlElement, T) | 
		 将当前元素的子元素之一替换为另一个 OpenXmlElement 元素。 (继承自 OpenXmlCompositeElement) | 
        	
| SetAttribute(OpenXmlAttribute) | 
		 将特性设置为指定的元素。 如果该属性是已知属性,则设置该特性的值。 如果该属性是扩展属性,则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement) | 
        	
| SetAttributes(IEnumerable<OpenXmlAttribute>) | 
		 设置元素的多个属性。 如果属性是已知属性,则会设置该属性的值。 如果属性是扩展属性,则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement) | 
        	
| WriteTo(XmlWriter) | 
		 将当前节点保存到指定的 XmlWriter。 (继承自 OpenXmlElement) | 
        	
显式接口实现
| IEnumerable.GetEnumerator() | 
		 细胞。 此类在 Office 2007 及更高版本中提供。 当对象序列化为 xml 时,其限定名称为 x:c。 (继承自 OpenXmlElement) | 
        	
| IEnumerable<OpenXmlElement>.GetEnumerator() | 
		 返回循环访问子集合的枚举器。 (继承自 OpenXmlElement) |