Column 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.
Largura e formatação da coluna.
Esta classe está disponível no Office 2007 e superior.
Quando o objeto é serializado como xml, seu nome qualificado é x:col.
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(22, "col")]
public class Column : DocumentFormat.OpenXml.OpenXmlLeafElementpublic class Column : DocumentFormat.OpenXml.OpenXmlLeafElement[DocumentFormat.OpenXml.SchemaAttr(22, "col")]
public class Column : DocumentFormat.OpenXml.OpenXmlLeafElement[DocumentFormat.OpenXml.SchemaAttr("x:col")]
public class Column : DocumentFormat.OpenXml.OpenXmlLeafElement[DocumentFormat.OpenXml.SchemaAttr("x:col")]
public class Column : DocumentFormat.OpenXml.TypedOpenXmlLeafElement[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class Column : DocumentFormat.OpenXml.OpenXmlLeafElement[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(22, "col")>]
type Column = class
inherit OpenXmlLeafElementtype Column = class
inherit OpenXmlLeafElement[<DocumentFormat.OpenXml.SchemaAttr(22, "col")>]
type Column = class
inherit OpenXmlLeafElement[<DocumentFormat.OpenXml.SchemaAttr("x:col")>]
type Column = class
inherit OpenXmlLeafElement[<DocumentFormat.OpenXml.SchemaAttr("x:col")>]
type Column = class
inherit TypedOpenXmlLeafElement[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type Column = class
inherit OpenXmlLeafElementPublic Class Column
Inherits OpenXmlLeafElementPublic Class Column
Inherits TypedOpenXmlLeafElement- Herança
- Herança
- Atributos
Exemplos
O exemplo a seguir abre um documento de planilha para acesso somente leitura. Usando o nome da planilha e o nome da célula, ele obtém o nome da coluna e o exibe.
using System;
using System.Collections.Generic;
using System.Linq;
using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Spreadsheet;
using System.Text.RegularExpressions;
namespace ColumnEx
{
class Program
{
// Given a document name, a worksheet name, and a cell name, gets the column of the cell.
static void Main(string[] args)
{
string docName = @"C:\Users\Public\Documents\ColumnEx.xlsx";
string worksheetName = "Sheet1";
string cellName = "B2";
// Open the document as read-only.
using (SpreadsheetDocument document = SpreadsheetDocument.Open(docName, false))
{
IEnumerable<Sheet> sheets =
document.WorkbookPart.Workbook.Descendants<Sheet>()
.Where(s => s.Name == worksheetName);
WorksheetPart worksheetPart = (WorksheetPart)document
.WorkbookPart.GetPartById(sheets.First().Id);
// Get the column name for the specified cell.
// Create a regular expression to match the column name portion of the cell name.
Regex regex = new Regex("[A-Za-z]+");
Match match = regex.Match(cellName);
Console.WriteLine("{0} {1}","The column is:", match.Value);
Console.ReadKey();
}
}
}
}
// Output:
// The column is: B
Imports System.Collections.Generic
Imports System.Linq
Imports DocumentFormat.OpenXml.Packaging
Imports DocumentFormat.OpenXml.Spreadsheet
Imports System.Text.RegularExpressions
Module Module1
' Given a document name, a worksheet name, and a cell name, gets the column of the cell.
Sub Main(ByVal args As String())
Dim docName As String = "C:\Users\Public\Documents\ColumnEx.xlsx"
Dim worksheetName As String = "Sheet1"
Dim cellName As String = "B2"
' Open the document as read-only.
Using document As SpreadsheetDocument = SpreadsheetDocument.Open(docName, False)
Dim sheets As IEnumerable(Of Sheet) = document.WorkbookPart.Workbook.Descendants(Of Sheet)().Where(Function(s) s.Name = worksheetName)
Dim worksheetPart As WorksheetPart = DirectCast(document.WorkbookPart.GetPartById(sheets.First().Id), WorksheetPart)
' Get the column name for the specified cell.
' Create a regular expression to match the column name portion of the cell name.
Dim regex As New Regex("[A-Za-z]+")
Dim match As Match = regex.Match(cellName)
Console.WriteLine("{0} {1}", "The column is:", match.Value)
Console.ReadKey()
End Using
End Sub
End Module
' Output:
' The column is: B
Comentários
[ISO/IEC 29500-1 1st Edition]
col (Largura da Coluna & Formatação)
Define a largura e a formatação da coluna para uma ou mais colunas da planilha.
[Exemplo: este exemplo mostra que a coluna 5 (E) tem informações de largura e estilo aplicadas.
<col min="5" max="5" width="9.140625" style="3"/>
exemplo de término]
| Elementos pai |
|---|
| cols (§18.3.1.17) |
| Atributos | Descrição |
|---|---|
| bestFit (largura da coluna de melhor ajuste) | Sinalizador que indica se a(s) coluna(s) especificada(s) está(ão) definida(s) como 'melhor ajuste'. "Melhor ajuste" é definido como verdadeiro sob estas condições: - A largura da coluna nunca foi definida manualmente pelo usuário, - A largura da coluna não é a largura padrão - 'Melhor ajuste' significa que quando os números são digitados em uma célula contida em uma coluna 'Melhor ajuste', a largura da coluna deve ser redimensionada automaticamente para exibir o número. [Observação: nos casos de melhor ajuste, a largura da coluna não deve ser reduzida, apenas maior. nota final] Os valores possíveis para esse atributo são definidos pelo tipo de dados booleano do esquema XML do W3C. |
| recolhido (Recolhido) | Sinalizador indicando se o contorno das colunas afetadas está no estado recolhido. Consulte a descrição da linha recolhida e os atributos summaryBelow e summaryRight do elemento outlinePr para obter informações detalhadas. Os valores possíveis para esse atributo são definidos pelo tipo de dados booleano do esquema XML do W3C. |
| customWidth (largura personalizada) | Sinalizador indicando que a largura da coluna para a(s) coluna(s) afetada(s) é diferente do padrão ou foi definida manualmente. Os valores possíveis para esse atributo são definidos pelo tipo de dados booleano do esquema XML do W3C. |
| oculto (colunas ocultas) | Sinalizador que indica se as colunas afetadas estão ocultas nesta planilha. Os valores possíveis para esse atributo são definidos pelo tipo de dados booleano do esquema XML do W3C. |
| max (Coluna Máxima) | Última coluna afetada por esse registro de 'informações da coluna'. Os valores possíveis para esse atributo são definidos pelo tipo de dados unsignedInt do esquema XML do W3C. |
| min (Coluna mínima) | Primeira coluna afetada por esse registro de 'informações da coluna'. Os valores possíveis para esse atributo são definidos pelo tipo de dados unsignedInt do esquema XML do W3C. |
| outlineLevel (Nível da estrutura de tópicos) | Nível de estrutura de tópicos das colunas afetadas. O intervalo é de 0 a 7. Consulte a descrição dos atributos summaryBelow e summaryRight do elemento outlinePr para obter informações detalhadas. Os valores possíveis para esse atributo são definidos pelo tipo de dados unsignedByte do esquema XML do W3C. |
| fonética (mostrar informações fonéticas) | Sinalizador indicando se as informações fonéticas devem ser exibidas por padrão para as colunas afetadas da planilha. Os valores possíveis para esse atributo são definidos pelo tipo de dados booleano do esquema XML do W3C. |
| estilo (Estilo) | Estilo padrão para a(s) coluna(s) afetada(s). Afeta as células ainda não alocadas na(s) coluna(s). Em outras palavras, esse estilo se aplica a novas colunas. Os valores possíveis para esse atributo são definidos pelo tipo de dados unsignedInt do esquema XML do W3C. |
| largura (Largura da Coluna) | Largura da coluna medida como o número de caracteres da largura máxima dos dígitos dos números 0, 1, 2, ..., 9 conforme renderizado na fonte do estilo normal. Existem 4 pixels de preenchimento de margem (dois de cada lado), além de preenchimento de 1 pixel para as linhas de grade. largura = Truncate([{Número de caracteres} * {Largura máxima do dígito} + {Preenchimento de 5 pixels}]/{Largura máxima do dígito}*256)/256 [Exemplo: usando a fonte Calibri como exemplo, a largura máxima do dígito do tamanho da fonte de 11 pontos é de 7 pixels (a 96 dpi). Na verdade, cada dígito tem a mesma largura para essa fonte. Portanto, se a largura da célula tiver 8 caracteres de largura, o valor desse atributo deverá ser Truncate([8*7+5]/7*256)/256 = 8,7109375. exemplo de término] Para converter o valor de largura no arquivo no valor de largura da coluna em tempo de execução (expresso em termos de pixels), use este cálculo: =Truncate(((256 * {width} + Truncate(128/{Largura máxima do dígito}))/256)*{Largura máxima do dígito}) [Exemplo: Usando o mesmo exemplo acima, o cálculo seria Truncate(((256*8.7109375+Truncate(128/7))/256)*7) = 61 pixels. exemplo de término] Para converter de pixels em largura de caractere, use este cálculo: =Truncate(({pixels}-5)/{Largura máxima do dígito} * 100+0,5)/100 [Exemplo: Usando o exemplo acima, o cálculo seria Truncate((61-5)/7*100+0,5)/100 = 8 caracteres. exemplo de término] [Observação: quando bordas largas são aplicadas, parte da borda esquerda/direita deve se sobrepor ao preenchimento de 2 pixels em cada lado. As bordas largas não afetam o cálculo da largura da coluna. nota final] [Observação: quando a planilha está no modo de exibir fórmulas em vez de valores, a largura de pixel da coluna é dobrada. nota final] Os valores possíveis para esse atributo são definidos pelo tipo de dados duplo do esquema XML do W3C. |
[Observação: a definição do esquema XML do W3C do modelo de conteúdo desse elemento (CT_Col) está localizada em §A.2. nota final]
ISO/IEC29500: 2008.
Construtores
| Nome | Description |
|---|---|
| Column() |
Inicializa uma nova instância da classe Column. |
Propriedades
| Nome | Description |
|---|---|
| BestFit |
Melhor ajuste da largura da coluna Representa o seguinte atributo no esquema: bestFit |
| ChildElements |
Obtém todos os nós filhos do elemento atual. (Herdado de OpenXmlElement) |
| Collapsed |
Recolhido Representa o seguinte atributo no esquema: recolhido |
| CustomWidth |
Largura personalizada Representa o seguinte atributo no esquema: customWidth |
| 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. Retorna null (Nothing no Visual Basic) se não existe esse elemento OpenXmlElement. (Herdado de OpenXmlElement) |
| 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 OpenXmlLeafElement) |
| Hidden |
Colunas ocultas Representa o seguinte atributo no esquema: oculto |
| InnerText |
Obtém ou define os valores concatenados do nó e de todos os seus filhos. (Herdado de OpenXmlElement) |
| InnerXml |
Obtém ou define a marcação que representa apenas elementos filho do elemento atual. (Herdado de OpenXmlLeafElement) |
| LastChild |
Obtém o último filho do elemento OpenXmlElement. Retorna null (Nothing no Visual Basic) se não existe esse elemento OpenXmlElement. (Herdado de OpenXmlElement) |
| LocalName |
Largura e formatação da coluna. Esta classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, seu nome qualificado é x:col. |
| LocalName |
Obtém o nome local do elemento atual. (Herdado de OpenXmlElement) |
| Max |
Máximo de Colunas Representa o seguinte atributo no esquema: max |
| 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) |
| Min |
Mínimo de Colunas Representa o seguinte atributo no esquema: min |
| 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) |
| Phonetic |
Mostrar informações fonéticas Representa o seguinte atributo no esquema: fonético |
| Prefix |
Obtém o prefixo do namespace do elemento atual. (Herdado de OpenXmlElement) |
| Style |
Style Representa o seguinte atributo no esquema: style |
| Width |
Largura da Coluna Representa o seguinte atributo no esquema: width |
| 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) |
| 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 OpenXmlElement) |
| 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 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 filho 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 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 elementos filho do elemento atual. (Herdado de OpenXmlElement) |
| 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 OpenXmlLeafElement) |
| 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 da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement) |
| 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 elemento filho por outro elemento filho na lista de elementos filho do elemento atual. (Herdado de OpenXmlElement) |
| 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() |
Largura e formatação da coluna. Esta classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, seu nome qualificado é x:col. (Herdado de OpenXmlElement) |
| IEnumerable<OpenXmlElement>.GetEnumerator() |
Retorna um enumerador que itera por meio da coleção filho. (Herdado de OpenXmlElement) |