Row 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.
do Azure.
Esta classe está disponível no Office 2007 e superior.
Quando o objeto é serializado como xml, seu nome qualificado é x:row.
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.Cell))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.ExtensionList))]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(22, "row")]
public class Row : DocumentFormat.OpenXml.OpenXmlCompositeElement
public class Row : DocumentFormat.OpenXml.OpenXmlCompositeElement
[DocumentFormat.OpenXml.SchemaAttr(22, "row")]
public class Row : DocumentFormat.OpenXml.OpenXmlCompositeElement
[DocumentFormat.OpenXml.SchemaAttr("x:row")]
public class Row : DocumentFormat.OpenXml.OpenXmlCompositeElement
[DocumentFormat.OpenXml.SchemaAttr("x:row")]
public class Row : DocumentFormat.OpenXml.TypedOpenXmlCompositeElement
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.Cell))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.ExtensionList))]
public class Row : DocumentFormat.OpenXml.OpenXmlCompositeElement
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.Cell))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.ExtensionList))]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class Row : DocumentFormat.OpenXml.OpenXmlCompositeElement
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.Cell))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.ExtensionList))>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(22, "row")>]
type Row = class
inherit OpenXmlCompositeElement
type Row = class
inherit OpenXmlCompositeElement
[<DocumentFormat.OpenXml.SchemaAttr(22, "row")>]
type Row = class
inherit OpenXmlCompositeElement
[<DocumentFormat.OpenXml.SchemaAttr("x:row")>]
type Row = class
inherit OpenXmlCompositeElement
[<DocumentFormat.OpenXml.SchemaAttr("x:row")>]
type Row = class
inherit TypedOpenXmlCompositeElement
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.Cell))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.ExtensionList))>]
type Row = class
inherit OpenXmlCompositeElement
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.Cell))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.ExtensionList))>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type Row = class
inherit OpenXmlCompositeElement
Public Class Row
Inherits OpenXmlCompositeElement
Public Class Row
Inherits TypedOpenXmlCompositeElement
- Herança
- Herança
- Atributos
Exemplos
O exemplo de código a seguir cria uma planilha de documentos, adiciona uma linha à tabela de células e escreve o número "123" na célula A1.
using System;
using DocumentFormat.OpenXml;
using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Spreadsheet;
namespace RowEx
{
class Program
{
static void Main(string[] args)
{
string fileName = @"C:\Users\Public\Documents\RowEx.xlsx";
// Create a spreadsheet document by using the file name.
SpreadsheetDocument spreadsheetDocument =
SpreadsheetDocument.Create(fileName, SpreadsheetDocumentType.Workbook);
// Add a WorkbookPart and Workbook objects.
WorkbookPart workbookpart = spreadsheetDocument.AddWorkbookPart();
workbookpart.Workbook = new Workbook();
// Add a WorksheetPart.
WorksheetPart worksheetPart = workbookpart.AddNewPart<WorksheetPart>();
// Create Worksheet and SheetData objects.
worksheetPart.Worksheet = new Worksheet(new SheetData());
// Add a Sheets object.
Sheets sheets = spreadsheetDocument.WorkbookPart.Workbook
.AppendChild<Sheets>(new Sheets());
// Append the new worksheet named "mySheet" and associate it
// with the workbook.
Sheet sheet = new Sheet()
{
Id = spreadsheetDocument.WorkbookPart
.GetIdOfPart(worksheetPart),
SheetId = 1,
Name = "mySheet"
};
sheets.Append(sheet);
// Get the sheetData cell table.
SheetData sheetData = worksheetPart.Worksheet.GetFirstChild<SheetData>();
// Add a row to the cell table.
Row row;
row = new Row() { RowIndex = 1 };
sheetData.Append(row);
// Add the cell to the cell table at A1.
Cell refCell = null;
Cell newCell = new Cell() { CellReference = "A1" };
row.InsertBefore(newCell, refCell);
// Set the cell value to be a numeric value of 123.
newCell.CellValue = new CellValue("123");
newCell.DataType = new EnumValue<CellValues>(CellValues.Number);
// Close the document.
spreadsheetDocument.Close();
Console.WriteLine("All done. Press 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\RowEx.xlsx"
' Create a spreadsheet document by using the file name.
Dim spreadsheetDocument As SpreadsheetDocument = _
spreadsheetDocument.Create(fileName, SpreadsheetDocumentType.Workbook)
' Add a WorkbookPart and Workbook objects.
Dim workbookpart As WorkbookPart = spreadsheetDocument.AddWorkbookPart()
workbookpart.Workbook = New Workbook()
' Add a WorksheetPart.
Dim worksheetPart As WorksheetPart = _
workbookpart.AddNewPart(Of WorksheetPart)()
' Create Worksheet and SheetData objects.
worksheetPart.Worksheet = New Worksheet(New SheetData())
' Add a Sheets object.
Dim sheets As Sheets = _
spreadsheetDocument.WorkbookPart.Workbook.AppendChild(Of Sheets)(New Sheets())
' Append the new worksheet named "mySheet" and associate it
' with the workbook.
Dim sheet As New Sheet() With { _
.Id = SpreadsheetDocument.WorkbookPart.GetIdOfPart(worksheetPart), _
.SheetId = 1, _
.Name = "mySheet" _
}
sheets.Append(sheet)
' Get the sheetData cell table.
Dim sheetData As SheetData = _
worksheetPart.Worksheet.GetFirstChild(Of SheetData)()
' Add a row to the cell table.
Dim row As Row
row = New Row() With { _
.RowIndex = 1 _
}
sheetData.Append(row)
' Add the cell to the cell table at A1.
Dim refCell As Cell = Nothing
Dim newCell As New Cell() With { _
.CellReference = "A1" _
}
row.InsertBefore(newCell, refCell)
' Set the cell value to be a numeric value of 123.
newCell.CellValue = New CellValue("123")
newCell.DataType = New EnumValue(Of CellValues)(CellValues.Number)
' Close the document.
spreadsheetDocument.Close()
Console.WriteLine("All done. Press a key")
Console.ReadKey()
End Sub
End Module
Comentários
[ISO/IEC 29500-1 1st Edition]
row (Row)
O elemento expressa informações sobre uma linha inteira de uma planilha e contém todas as definições de célula para uma linha específica na planilha.
[Exemplo:
Essa linha expressa informações sobre a linha da planilha e contém três definições de célula.
<row r="2" spans="2:12">
<c r="C2" s="1">
<f>PMT(B3/12,B4,-B5)</f>
<v>672.68336574300008</v>
</c>
<c r="D2">
<v>180</v>
</c>
<c r="E2">
<v>360</v>
</c>
</row>
exemplo de término]
| Elementos pai |
|---|
| sheetData (§18.3.1.80) |
| Elementos filho | Subcláusula |
|---|---|
| c (Célula) | §18.3.1.4 |
| extLst (área de armazenamento de dados de recursos futuros) | §18.2.10 |
[Observação: a definição do esquema XML do W3C do modelo de conteúdo (CT_Row) desse elemento está localizada em §A.2. nota final]
ISO/IEC29500: 2008.
Construtores
| Nome | Description |
|---|---|
| Row() |
Inicializa uma nova instância da classe Row. |
| Row(IEnumerable<OpenXmlElement>) |
Inicializa uma nova instância da classe Row com os elementos filho especificados. |
| Row(OpenXmlElement[]) |
Inicializa uma nova instância da classe Row com os elementos filho especificados. |
| Row(String) |
Inicializa uma nova instância da classe Row do XML externo. |
Propriedades
| Nome | Description |
|---|---|
| ChildElements |
Obtém todos os nós filhos do elemento atual. (Herdado de OpenXmlElement) |
| Collapsed |
Recolhido Representa o seguinte atributo no esquema: recolhido |
| CustomFormat |
Formato personalizado Representa o seguinte atributo no esquema: customFormat |
| CustomHeight |
Altura Personalizada Representa o seguinte atributo no esquema: customHeight |
| DyDescent |
dyDescent, esta propriedade só está disponível no Office 2010 e posterior. Representa o seguinte atributo no esquema: x14ac:dyDescent |
| ExtendedAttributes |
Obtém todos os atributos estendidos (atributos não definidos no esquema) do elemento atual. (Herdado de OpenXmlElement) |
| Features |
Obtém um IFeatureCollection para o elemento atual. Essa coleção de recursos será somente leitura, mas herdará recursos de sua parte pai e pacote, se disponível. (Herdado de OpenXmlElement) |
| FirstChild |
Obtém o primeiro filho do elemento OpenXmlElement atual. (Herdado de OpenXmlCompositeElement) |
| HasAttributes |
Obtém um valor que indica se o elemento atual tem algum atributo. (Herdado de OpenXmlElement) |
| HasChildren |
Obtém um valor que indica se o elemento atual tem algum elemento filho. (Herdado de OpenXmlCompositeElement) |
| Height |
Altura da linha Representa o seguinte atributo no esquema: ht |
| Hidden |
Hidden Representa o seguinte atributo no esquema: oculto |
| InnerText |
Obtém ou define os valores concatenados do nó atual e de todos os seus filhos. (Herdado de OpenXmlCompositeElement) |
| InnerXml |
Obtém ou define a marcação que representa apenas os nós filhos do nó atual. (Herdado de OpenXmlCompositeElement) |
| LastChild |
Obtém o último filho do elemento OpenXmlElement atual. Retorna null (Nothing no Visual Basic) se não existe esse elemento OpenXmlElement. (Herdado de OpenXmlCompositeElement) |
| LocalName |
do Azure. Esta classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, seu nome qualificado é x:row. |
| LocalName |
Obtém o nome local do elemento atual. (Herdado de OpenXmlElement) |
| MCAttributes |
Obtém ou define os atributos de compatibilidade de marcação. Retorna null se nenhum atributo de compatibilidade de marcação for definido para o elemento atual. (Herdado de OpenXmlElement) |
| NamespaceDeclarations |
Obtém todas as declarações de namespace definidas no elemento atual. Retorna um enumerador vazio se não houver nenhuma declaração de namespace. (Herdado de OpenXmlElement) |
| NamespaceUri |
Obtém o URI do namespace 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 seus elementos filho. (Herdado de OpenXmlElement) |
| OutlineLevel |
Nível da estrutura de tópicos Representa o seguinte atributo no esquema: outlineLevel |
| Parent |
Obtém o elemento pai do elemento atual. (Herdado de OpenXmlElement) |
| Prefix |
Obtém o prefixo do namespace do elemento atual. (Herdado de OpenXmlElement) |
| RowIndex |
Índice da Linha Representa o seguinte atributo no esquema: r |
| ShowPhonetic |
Mostrar fonética Representa o seguinte atributo no esquema: ph |
| Spans |
Extensões Representa o seguinte atributo no esquema: Intervalos |
| StyleIndex |
Índice de Estilo Representa o seguinte atributo no esquema: s |
| ThickBot |
Fundo Grosso Representa o seguinte atributo no esquema: thickBot |
| ThickTop |
borda superior grossa Representa o seguinte atributo no esquema: thickTop |
| 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
| Nome | Description |
|---|---|
| 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 filho conhecido. Isso adiciona o elemento no local correto de acordo com o esquema. (Herdado de OpenXmlCompositeElement) |
| AddNamespaceDeclaration(String, String) |
Adiciona uma declaração de namespace ao nó atual. (Herdado de OpenXmlElement) |
| Ancestors() |
Enumera todos os ancestrais do elemento atual. (Herdado de OpenXmlElement) |
| Ancestors<T>() |
Enumera apenas os ancestrais do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement) |
| Annotation(Type) |
Obtenha o primeiro objeto de anotação do tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement) |
| Annotation<T>() |
Obtenha o primeiro objeto de anotação do tipo especificado 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 final da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement) |
| Append(OpenXmlElement[]) |
Acrescenta cada elemento de uma matriz de elementos ao final da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement) |
| AppendChild<T>(T) |
Anexa o elemento especificado ao final da lista de nós filhos do elemento atual. (Herdado de OpenXmlCompositeElement) |
| ClearAllAttributes() |
Limpa todos os atributos, incluindo atributos conhecidos e atributos estendidos. (Herdado de OpenXmlElement) |
| Clone() |
Cria uma duplicata do nó atual. (Herdado de OpenXmlElement) |
| CloneNode(Boolean) |
Cria uma duplicata desse nó. |
| Descendants() |
Enumera todos os descendentes do elemento atual. (Herdado de OpenXmlElement) |
| Descendants<T>() |
Enumere todos os descendentes do elemento atual do tipo T. (Herdado de OpenXmlElement) |
| Elements() |
Enumera todos os filhos do elemento atual. (Herdado de OpenXmlElement) |
| Elements<T>() |
Enumera apenas os filhos do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement) |
| ElementsAfter() |
Enumera todos os elementos irmãos que seguem o elemento atual e têm o mesmo pai que o elemento atual. (Herdado de OpenXmlElement) |
| ElementsBefore() |
Enumera todos os elementos irmãos que precedem o elemento atual e têm o mesmo pai que o elemento atual. (Herdado de OpenXmlElement) |
| GetAttribute(String, String) |
Obtém um atributo Open XML com o nome da marca especificado e o URI do namespace. (Herdado de OpenXmlElement) |
| GetAttributes() |
Obtém uma lista que contém uma cópia de todos os atributos. (Herdado de OpenXmlElement) |
| GetEnumerator() |
Retorna um enumerador que itera por meio da coleção filho. (Herdado de OpenXmlElement) |
| GetFirstChild<T>() |
Localiza o primeiro elemento filho 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 filhos 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 após 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 namespace no contexto do nó atual. (Herdado de OpenXmlElement) |
| LookupPrefix(String) |
Localiza o prefixo correspondente para um URI de namespace no escopo do elemento atual. (Herdado de OpenXmlElement) |
| NextSibling() |
Obtém o elemento OpenXmlElement que segue imediatamente o elemento OpenXmlElement atual. Retorna null (Nothing no Visual Basic) se não houver nenhum próximo elemento OpenXmlElement. (Herdado de OpenXmlElement) |
| NextSibling<T>() |
Obtém o elemento OpenXmlElement com o tipo especificado que segue o elemento OpenXmlElement atual. Retorna null (Nothing no Visual Basic) se não houver próximo OpenXmlElement. (Herdado de OpenXmlElement) |
| PrependChild<T>(T) |
Insere o elemento especificado no início da lista de nós filhos do elemento atual. (Herdado de OpenXmlCompositeElement) |
| PreviousSibling() |
Obtém o elemento OpenXmlElement que precede imediatamente o elemento OpenXmlElement atual. Retorna nulo (nada no Visual Basic ) se não houver nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement) |
| PreviousSibling<T>() |
Obtém o elemento OpenXmlElement com o tipo especificado que precede o OpenXmlElement atual. Retorna nulo (nada no Visual Basic) se não houver nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement) |
| Remove() |
Remove o elemento atual de seu pai. (Herdado de OpenXmlElement) |
| RemoveAllChildren() |
Remove todos os elementos filho do elemento atual. (Herdado de OpenXmlCompositeElement) |
| RemoveAllChildren<T>() |
Remova todos os elementos filho 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 filho especificado. (Herdado de OpenXmlCompositeElement) |
| RemoveNamespaceDeclaration(String) |
Remove a declaração de namespace para o prefixo especificado. Não removerá nada se não houver prefixo. (Herdado de OpenXmlElement) |
| ReplaceChild<T>(OpenXmlElement, T) |
Substitui um dos elementos filho do elemento atual por outro elemento OpenXmlElement. (Herdado de OpenXmlCompositeElement) |
| SetAttribute(OpenXmlAttribute) |
Define um atributo para o elemento especificado. Se o atributo for conhecido, o valor do atributo será definido. Se o atributo for um atributo estendido, o 'openxmlAttribute' será adicionado à lista de atributos estendidos. (Herdado de OpenXmlElement) |
| SetAttributes(IEnumerable<OpenXmlAttribute>) |
Define vários atributos para o elemento. Se um atributo for conhecido, o valor do atributo será definido. Se um atributo for um atributo estendido, o 'openxmlAttribute' será adicionado à lista de atributos estendidos. (Herdado de OpenXmlElement) |
| WriteTo(XmlWriter) |
Salva o nó atual no XmlWriter especificado. (Herdado de OpenXmlElement) |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IEnumerable.GetEnumerator() |
do Azure. Esta classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, seu nome qualificado é x:row. (Herdado de OpenXmlElement) |
| IEnumerable<OpenXmlElement>.GetEnumerator() |
Retorna um enumerador que itera por meio da coleção filho. (Herdado de OpenXmlElement) |