Cell Classe

Definição

Namespace:

DocumentFormat.OpenXml.Spreadsheet

Assembly:

DocumentFormat.OpenXml.dll

Pacote:

DocumentFormat.OpenXml v3.0.1

Célula.

Esta classe está disponível no Office 2007 e superior.

Quando o objeto é serializado como xml, o nome qualificado é x:c.

public class Cell : DocumentFormat.OpenXml.Spreadsheet.CellType

type Cell = class
    inherit CellType

Public Class Cell
Inherits CellType

Herança

Object

OpenXmlElement

OpenXmlCompositeElement

CellType

Cell

Exemplos

O seguinte exemplo de código cria um novo livro, insere uma folha de cálculo no mesmo e escreve a palavra "Microsoft" num endereço de célula especificado.

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  

Comentários

[ISO/IEC 29500-1 1st Edition]

c (Célula)

Esta coleção representa uma célula na folha de cálculo. As informações sobre a localização (referência) da célula, o valor, o tipo de dados, a formatação e a fórmula são expressas aqui.

[Exemplo: este exemplo mostra as informações armazenadas para uma célula cujo endereço na grelha é C6, cujo índice de estilo é "6" e cujo índice de metadados de valor é "15". A célula contém uma fórmula, bem como um resultado calculado dessa fórmula.

<c r="C6" s="1" vm="15">  
  <f>CUBEVALUE("xlextdat9 Adventure Works",C$5,$A6)</f>  
  <v>2838512.355</v>  
</c>  

exemplo final]

Embora uma célula possa ter um elemento de fórmula f e um elemento de valor v, quando o tipo de célula t é inlineStr , apenas o elemento é permitido como elemento subordinado.

[Exemplo:

Eis um exemplo de expressão de uma cadeia na célula em vez de utilizar a tabela de cadeia partilhada.

<row r="1" spans="1:1">  
  <c r="A1" t="inlineStr">  
    <is><t>This is inline string example</t></is>  
  </c>  
</row>  

exemplo final]

Elementos pai
linha (}18.3.1.73)

Elementos filho	Subclautilizar
extLst (Área de Armazenamento de Dados de Funcionalidades Futuras)	§18.2.10
f (Fórmula)	§18.3.1.40
is (Rich Text Inline)	§18.3.1.53
v (Valor da Célula)	§18.3.1.96

Atributos	Descrição
cm (Índice de Metadados de Células)	O índice baseado em zero do registo de metadados de células associado a esta célula. As informações de metadados encontram-se na Peça metadados. Os metadados das células são informações adicionais armazenadas ao nível da célula e estão anexadas à célula (percorre os movimentos, copia/cola, limpa, etc.). Os metadados de célula não estão acessíveis através da referência de fórmulas. Os valores possíveis para este atributo são definidos pelo tipo de dados W3C XML Schema unsignedInt .
ph (Mostrar Fonético)	Um valor booleano que indica se a aplicação de folha de cálculo deve mostrar informações fonéticas. As informações fonéticas são apresentadas na mesma célula na parte superior da célula e servem como uma "sugestão" que indica como o texto deve ser pronunciado. Esta ação só deve ser utilizada para idiomas do Leste Asiático. Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C.
r (Referência)	Uma referência de estilo A1 à localização desta célula Os valores possíveis para este atributo são definidos pelo ST_CellRef tipo simples (}18.18.7).
s (Índice de Estilos)	O índice do estilo desta célula. Os registos de estilo são armazenados na Peça Estilos. Os valores possíveis para este atributo são definidos pelo tipo de dados W3C XML Schema unsignedInt .
t (Tipo de Dados da Célula)	Uma enumeração que representa o tipo de dados da célula. Os valores possíveis para este atributo são definidos pelo ST_CellType tipo simples (}18.18.11).
vm (Índice de Metadados de Valor)	O índice baseado em zero do registo de metadados de valor associado ao valor desta célula. Os registos de metadados são armazenados na Peça metadados. Os metadados de valor são informações adicionais armazenadas ao nível da célula, mas associadas ao valor em vez da própria célula. Os metadados de valor são acessíveis através da referência de fórmulas. Os valores possíveis para este atributo são definidos pelo tipo de dados W3C XML Schema unsignedInt .

[Nota: a definição de Esquema XML W3C do modelo de conteúdo deste elemento (CT_Cell) está localizada em {A.2. nota de fim]

ISO/IEC29500: 2008.

Construtores

Cell()	Inicializa uma nova instância da classe Célula.
Cell(IEnumerable<OpenXmlElement>)	Inicializa uma nova instância da classe Célula com os elementos subordinados especificados.
Cell(OpenXmlElement[])	Inicializa uma nova instância da classe Célula com os elementos subordinados especificados.
Cell(String)	Inicializa uma nova instância da classe Cell a partir de XML externo.

Propriedades

CellFormula	Fórmula. Representa a seguinte etiqueta de elemento no esquema: x:f. (Herdado de CellType)
CellMetaIndex	Índice de Metadados de Células Representa o seguinte atributo no esquema: cm (Herdado de CellType)
CellReference	Referências Representa o seguinte atributo no esquema: r (Herdado de CellType)
CellValue	Valor da Célula. Representa a seguinte etiqueta de elemento no esquema: x:v. (Herdado de CellType)
ChildElements	Obtém todos os nós subordinados do elemento atual. (Herdado de OpenXmlElement)
DataType	Tipo de Dados da Célula Representa o seguinte atributo no esquema: t (Herdado de CellType)
ExtendedAttributes	Obtém todos os atributos expandidos (atributos não definidos no esquema) do elemento atual. (Herdado de OpenXmlElement)
ExtensionList	Área de Armazenamento de Dados de Funcionalidades Futuras. Representa a seguinte etiqueta de elemento no esquema: x:extLst. (Herdado de CellType)
Features	Obtém um IFeatureCollection para o elemento atual. Esta coleção de funcionalidades será só de leitura, mas herdará as funcionalidades da parte principal e do pacote, se disponível. (Herdado de OpenXmlElement)
FirstChild	Obtém o primeiro elemento subordinado do elemento OpenXmlElement atual. (Herdado de OpenXmlCompositeElement)
HasAttributes	Obtém um valor que indica se o elemento atual tem atributos. (Herdado de OpenXmlElement)
HasChildren	Obtém um valor que indica se o elemento atual tem elementos subordinados. (Herdado de OpenXmlCompositeElement)
InlineString	Rich Text Inline. Representa a seguinte etiqueta de elemento no esquema: x:is. (Herdado de CellType)
InnerText	Obtém ou define os valores concatenados do nó atual e de todos os respetivos subordinados. (Herdado de OpenXmlCompositeElement)
InnerXml	Obtém ou define a marcação que representa apenas os nós subordinados do nó atual. (Herdado de OpenXmlCompositeElement)
LastChild	Obtém o último elemento subordinado do elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir esse elemento OpenXmlElement. (Herdado de OpenXmlCompositeElement)
LocalName	Obtém o nome local do elemento atual. (Herdado de OpenXmlElement)
MCAttributes	Obtém ou define os atributos de compatibilidade de markup. Devolve nulo se não forem definidos atributos de compatibilidade de markup para o elemento atual. (Herdado de OpenXmlElement)
NamespaceDeclarations	Obtém todas as declarações de espaço de nomes definidas no elemento atual. Devolve um enumerador vazio se não existir nenhuma declaração de espaço de nomes. (Herdado de OpenXmlElement)
NamespaceUri	Obtém o URI do espaço de nomes do elemento atual. (Herdado de OpenXmlElement)
OpenXmlElementContext	Obtém o OpenXmlElementContext do elemento atual. (Herdado de OpenXmlElement)
OuterXml	Obtém a marcação que representa o elemento atual e todos os respetivos elementos subordinados. (Herdado de OpenXmlElement)
Parent	Obtém o elemento principal do elemento atual. (Herdado de OpenXmlElement)
Prefix	Obtém o prefixo de espaço de nomes do elemento atual. (Herdado de OpenXmlElement)
ShowPhonetic	Mostrar Fonético Representa o seguinte atributo no esquema: ph (Herdado de CellType)
StyleIndex	Índice de Estilos Representa o seguinte atributo no esquema: s (Herdado de CellType)
ValueMetaIndex	Índice de Metadados de Valor Representa o seguinte atributo no esquema: vm (Herdado de CellType)
XmlQualifiedName	Obtém o nome qualificado do elemento atual. (Herdado de OpenXmlElement)
XName	Obtém o nome qualificado do elemento atual. (Herdado de OpenXmlElement)

Métodos

AddAnnotation(Object)	Adiciona um objeto à lista de anotações do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	Adiciona o elemento especificado ao elemento se for um subordinado conhecido. Esta ação adiciona o elemento na localização correta de acordo com o esquema. (Herdado de OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)	Adiciona uma declaração de espaço de nomes ao nó atual. (Herdado de OpenXmlElement)
Ancestors()	Enumera todos os predecessores do elemento atual. (Herdado de OpenXmlElement)
Ancestors<T>()	Enumera apenas os predecessores do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
Annotation(Type)	Obtenha o primeiro objeto de anotação do tipo especificado a partir do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotation<T>()	Obtenha o primeiro objeto de anotação do tipo especificado a partir do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotations(Type)	Obtém uma coleção de anotações com o tipo especificado para o elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotations<T>()	Obtém uma coleção de anotações com o tipo especificado para o elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Acrescenta cada elemento de uma lista de elementos ao fim da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
Append(OpenXmlElement[])	Acrescenta cada elemento de uma matriz de elementos ao fim da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
AppendChild<T>(T)	Acrescenta o elemento especificado ao fim da lista de nós subordinados do elemento atual. (Herdado de OpenXmlCompositeElement)
ClearAllAttributes()	Limpa todos os atributos, incluindo atributos conhecidos e atributos expandidos. (Herdado de OpenXmlElement)
Clone()	Cria um duplicado do nó atual. (Herdado de OpenXmlElement)
CloneNode(Boolean)	Cria um duplicado deste nó.
Descendants()	Enumera todos os descendentes do elemento atual. (Herdado de OpenXmlElement)
Descendants<T>()	Enumerar todos os descendentes do elemento atual do tipo T. (Herdado de OpenXmlElement)
Elements()	Enumera todos os elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
Elements<T>()	Enumera apenas os subordinados do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
ElementsAfter()	Enumera todos os elementos do elemento colateral que seguem o elemento atual e têm o mesmo elemento principal que o elemento atual. (Herdado de OpenXmlElement)
ElementsBefore()	Enumera todos os elementos do elemento colateral que precedem o elemento atual e têm o mesmo elemento principal que o elemento atual. (Herdado de OpenXmlElement)
GetAttribute(String, String)	Obtém um atributo Open XML com o nome da etiqueta especificado e o URI do espaço de nomes. (Herdado de OpenXmlElement)
GetAttributes()	Obtém uma lista que contém uma cópia de todos os atributos. (Herdado de OpenXmlElement)
GetFirstChild<T>()	Localiza o primeiro elemento subordinado no tipo T. (Herdado de OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Insere o elemento especificado imediatamente após o elemento de referência especificado. (Herdado de OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	Insere o elemento especificado imediatamente após o elemento atual. (Herdado de OpenXmlElement)
InsertAt<T>(T, Int32)	Insere o elemento especificado no índice especificado dos subordinados do elemento atual. (Herdado de OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	Insere o elemento especificado imediatamente antes do elemento de referência especificado. (Herdado de OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	Insere o elemento especificado imediatamente antes do elemento atual. (Herdado de OpenXmlElement)
IsAfter(OpenXmlElement)	Determina se o elemento atual aparece depois de um elemento especificado na ordem do documento. (Herdado de OpenXmlElement)
IsBefore(OpenXmlElement)	Determina se o elemento atual aparece antes de um elemento especificado na ordem do documento. (Herdado de OpenXmlElement)
LookupNamespace(String)	Resolve o prefixo do espaço de nomes no contexto do nó atual. (Herdado de OpenXmlElement)
LookupPrefix(String)	Localiza o prefixo correspondente para um URI de espaço de nomes no âmbito do elemento atual. (Herdado de OpenXmlElement)
NextSibling()	Obtém o elemento OpenXmlElement que segue imediatamente o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement seguinte. (Herdado de OpenXmlElement)
NextSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que segue o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir um OpenXmlElement seguinte. (Herdado de OpenXmlElement)
PrependChild<T>(T)	Insere o elemento especificado no início da lista de nós subordinados do elemento atual. (Herdado de OpenXmlCompositeElement)
PreviousSibling()	Obtém o elemento OpenXmlElement que precede imediatamente o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
PreviousSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que precede o OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
Remove()	Remove o elemento atual do respetivo elemento principal. (Herdado de OpenXmlElement)
RemoveAllChildren()	Remove todos os elementos subordinados do elemento atual. (Herdado de OpenXmlCompositeElement)
RemoveAllChildren<T>()	Remova todos os elementos subordinados do elemento atual que são do tipo T. (Herdado de OpenXmlElement)
RemoveAnnotations(Type)	Remove as anotações do tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
RemoveAnnotations<T>()	Remove as anotações com o tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
RemoveAttribute(String, String)	Remove o atributo do elemento atual. (Herdado de OpenXmlElement)
RemoveChild<T>(T)	Remove o elemento subordinado especificado. (Herdado de OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	Remove a declaração de espaço de nomes para o prefixo especificado. Não remove nada se não existir um prefixo. (Herdado de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Substitui um dos elementos subordinados do elemento atual por outro elemento OpenXmlElement. (Herdado de OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	Define um atributo para o elemento especificado. Se o atributo for um atributo conhecido, o valor do atributo é definido. Se o atributo for um atributo expandido, o "openxmlAttribute" é adicionado à lista de atributos expandidos. (Herdado de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Define vários atributos para o elemento . Se um atributo for um atributo conhecido, o valor do atributo é definido. Se um atributo for um atributo expandido, o "openxmlAttribute" é adicionado à lista de atributos expandidos. (Herdado de OpenXmlElement)
WriteTo(XmlWriter)	Guarda o nó atual no XmlWriter especificado. (Herdado de OpenXmlElement)

Implantações explícitas de interface

IEnumerable.GetEnumerator()	Célula. Esta classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, o nome qualificado é x:c. (Herdado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Devolve um enumerador que itera através da coleção subordinada. (Herdado de OpenXmlElement)