CellValue Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Isto fornece construtores adicionais do que nos ficheiros gerados.
public class CellValue : DocumentFormat.OpenXml.Spreadsheet.XstringType[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(22, "v")]
public class CellValue : DocumentFormat.OpenXml.Spreadsheet.XstringType[DocumentFormat.OpenXml.SchemaAttr(22, "v")]
public class CellValue : DocumentFormat.OpenXml.Spreadsheet.XstringType[DocumentFormat.OpenXml.SchemaAttr("x:v")]
public class CellValue : DocumentFormat.OpenXml.Spreadsheet.XstringType[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class CellValue : DocumentFormat.OpenXml.Spreadsheet.XstringTypetype CellValue = class
inherit XstringType[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(22, "v")>]
type CellValue = class
inherit XstringType[<DocumentFormat.OpenXml.SchemaAttr(22, "v")>]
type CellValue = class
inherit XstringType[<DocumentFormat.OpenXml.SchemaAttr("x:v")>]
type CellValue = class
inherit XstringType[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type CellValue = class
inherit XstringTypePublic Class CellValue
Inherits XstringType- Herança
- Herança
- Atributos
Exemplos
O exemplo de código seguinte cria um ficheiro de folha de cálculo com o nome "CellValue.xlsx" e escreve o texto "Microsoft" na célula A2.
using System;
using DocumentFormat.OpenXml;
using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Spreadsheet;
namespace CellTypeEx
{
class Program
{
static void Main(string[] args)
{
string fileName = @"C:\Users\Public\Documents\CellValueEx.xlsx";
// Create a spreadsheet document by supplying the fileName.
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() { RowIndex = 2U, Spans = new ListValue<StringValue>() };
Cell cell = new Cell()
{
CellReference = "A2",
DataType = CellValues.String,
CellValue = new CellValue("Microsoft")
};
row.Append(cell);
sheetData.Append(row);
worksheet.Append(sheetData);
worksheetPart.Worksheet = worksheet;
workbookpart.Workbook.Save();
// Close the document.
spreadsheetDocument.Close();
Console.WriteLine("All done.\nPress a key.");
Console.ReadKey();
}
}
}
Imports System
Imports DocumentFormat.OpenXml
Imports DocumentFormat.OpenXml.Packaging
Imports DocumentFormat.OpenXml.Spreadsheet
Module Module1
Sub Main(ByVal args As String())
Dim fileName As String = "C:\Users\Public\Documents\CellValueEx.xlsx"
' Create a spreadsheet document by supplying the fileName.
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() With { _
.RowIndex = 2UI, _
.Spans = New ListValue(Of StringValue)() _
}
Dim cell As New Cell() With { _
.CellReference = "A2", _
.DataType = CellValues.[String], _
.CellValue = New CellValue("Microsoft") _
}
row.Append(cell)
sheetData.Append(row)
worksheet.Append(sheetData)
worksheetPart.Worksheet = worksheet
workbookpart.Workbook.Save()
' Close the document.
spreadsheetDocument.Close()
Console.WriteLine("All done." & vbLf & "Press a key.")
Console.ReadKey()
End Sub
End Module
Comentários
[ISO/IEC 29500-1 1st Edition]
v (Valor da Célula)
Este elemento expressa o valor contido numa célula. Se a célula contiver uma cadeia, este valor é um índice na tabela de cadeia partilhada, apontando para o valor real da cadeia. Caso contrário, o valor da célula é expresso diretamente neste elemento. As células que contêm fórmulas expressam o último resultado calculado da fórmula neste elemento.
Para aplicações que não pretendam implementar a tabela de cadeia partilhada, uma "cadeia inline" pode ser expressa num <elemento is> em <c> (em vez de um <elemento v> em <c>),da mesma forma que uma cadeia seria expressa na tabela de cadeia partilhada. [Nota: Ver <é> , por exemplo. nota de fim]
[Exemplo: neste exemplo, a célula B4 contém o número "360" e C4 contém a data UTC 22 de novembro de 1976, 08:30.
<c r="B4">
<v>360</v>
</c>
<c r="C4" t="d">
<v>1976-11-22T08:30Z</v>
</c>
exemplo final]
Os valores possíveis para este elemento são definidos pela ST_Xstring tipo simples (}22.9.2.19).
| Elementos pai |
|---|
| c (}18.3.1.4); célula (}18.14.1); nc (}18.11.1.3); oc (}18.11.1.5); tp (}18.15.3) |
[Nota: a definição de Esquema XML W3C do modelo de conteúdo deste elemento (ST_Xstring) está localizada em {A.6.9. nota de fim]
ISO/IEC29500: 2008.
Construtores
| CellValue() |
Inicializa uma nova instância da classe CellValue. |
| CellValue(Boolean) | |
| CellValue(DateTime) |
Instancia uma instância de CellValue para um DateTime. As datas têm de estar no formato ISO 8601, o que este construtor garante |
| CellValue(DateTimeOffset) |
Instancia uma instância de CellValue para um DateTimeOffset. As datas têm de estar no formato ISO 8601, o que este construtor garante |
| CellValue(Decimal) | |
| CellValue(Double) | |
| CellValue(Int32) | |
| CellValue(String) |
Inicializa uma nova instância da classe CellValue com o conteúdo de texto especificado. |
Propriedades
| ChildElements |
Obtém todos os nós subordinados do elemento atual. (Herdado de OpenXmlElement) |
| ExtendedAttributes |
Obtém todos os atributos expandidos (atributos não definidos no esquema) do elemento atual. (Herdado de OpenXmlElement) |
| 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. Devolve nulo (Nada no Visual Basic) se não existir esse elemento OpenXmlElement. (Herdado de OpenXmlElement) |
| 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 OpenXmlLeafTextElement) |
| InnerText |
Obtém ou define os valores concatenados do elemento e todos os respetivos elementos subordinados. (Herdado de OpenXmlLeafTextElement) |
| InnerXml |
Obtém ou define a marcação que representa apenas elementos subordinados do elemento atual. (Herdado de OpenXmlLeafTextElement) |
| LastChild |
Obtém o último elemento subordinado do elemento OpenXmlElement. Devolve nulo (Nada no Visual Basic) se não existir esse elemento OpenXmlElement. (Herdado de OpenXmlElement) |
| LocalName |
Isto fornece construtores adicionais do que nos ficheiros gerados. |
| 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) |
| Space |
Conteúdo Contém Espaço em Branco Significativo Representa o seguinte atributo no esquema: xml:space (Herdado de XstringType) |
| Text |
Obtém ou define o texto do elemento atual. (Herdado de OpenXmlLeafTextElement) |
| 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) |
| 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 OpenXmlElement) |
| 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) |
| GetEnumerator() |
Devolve um enumerador que itera através da coleção subordinada. (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 OpenXmlElement) |
| 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 na lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement) |
| InsertBefore<T>(T, OpenXmlElement) |
Insere o elemento especificado imediatamente antes do elemento de referência especificado. (Herdado de OpenXmlElement) |
| 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 elementos subordinados do elemento atual. (Herdado de OpenXmlElement) |
| 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 OpenXmlLeafTextElement) |
| 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 da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement) |
| 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 elemento subordinado por outro elemento subordinado na lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement) |
| 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) |
| TryGetBoolean(Boolean) |
Tenta analisar o valor da célula para obter um Boolean. |
| TryGetDateTime(DateTime) |
Tenta analisar o valor da célula para obter um DateTime. |
| TryGetDateTimeOffset(DateTimeOffset) |
Tenta analisar o valor da célula para obter um DateTimeOffset. |
| TryGetDecimal(Decimal) |
Tenta analisar o valor da célula para obter um Decimal. |
| TryGetDouble(Double) |
Tenta analisar o valor da célula para obter um Double. |
| TryGetInt(Int32) |
Tenta analisar o valor da célula para obter um Int32. |
| WriteTo(XmlWriter) |
Guarda o nó atual no XmlWriter especificado. (Herdado de OpenXmlElement) |
Implantações explícitas de interface
| IEnumerable.GetEnumerator() |
Isto fornece construtores adicionais do que nos ficheiros gerados. (Herdado de OpenXmlElement) |
| IEnumerable<OpenXmlElement>.GetEnumerator() |
Devolve um enumerador que itera através da coleção subordinada. (Herdado de OpenXmlElement) |