Column Classe

Definição

Namespace:

DocumentFormat.OpenXml.Spreadsheet

Assembly:

DocumentFormat.OpenXml.dll

Pacote:

DocumentFormat.OpenXml v3.0.1

Largura da coluna e formatação.

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

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

public class Column : DocumentFormat.OpenXml.OpenXmlLeafElement

type Column = class
    inherit OpenXmlLeafElement

Public Class Column
Inherits OpenXmlLeafElement

Herança

Object

OpenXmlElement

OpenXmlLeafElement

Column

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 da coluna e a formatação de 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 final]

Elementos pai
cols (§18.3.1.17)

Atributos	Descrição
bestFit (largura da coluna best fit)	Sinalizador indicando se as colunas especificadas estão definidas como "melhor ajuste". O 'melhor ajuste' é definido como true nessas 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 redimensionar automaticamente para exibir o número. [Observação: nos casos mais adequados, a largura da coluna não deve ser menor, apenas maior. nota final] Os valores possíveis para esse atributo são definidos pelo tipo de dados booliano W3C XML Schema.
recolhida (Recolhida)	Sinalizador indicando se o delineamento das colunas afetadas está no estado de colapso. Confira a descrição dos atributos summaryBelow e summaryRight do elemento row collapsed e outlinePr para obter informações detalhadas. Os valores possíveis para esse atributo são definidos pelo tipo de dados booliano W3C XML Schema.
customWidth (Largura Personalizada)	Sinalizador indicando que a largura da coluna para as colunas afetadas é diferente do padrão ou foi definida manualmente. Os valores possíveis para esse atributo são definidos pelo tipo de dados booliano W3C XML Schema.
oculto (Colunas Ocultas)	Sinalizador indicando se as colunas afetadas estão ocultas nesta planilha. Os valores possíveis para esse atributo são definidos pelo tipo de dados booliano W3C XML Schema.
max (coluna máxima)	Última coluna afetada por este registro de "informações de coluna". Os valores possíveis para esse atributo são definidos pelo tipo de dados W3C XML Schema unsignedInt .
min (Coluna Mínima)	Primeira coluna afetada por este registro de "informações de coluna". Os valores possíveis para esse atributo são definidos pelo tipo de dados W3C XML Schema unsignedInt .
outlineLevel (nível de contorno)	Nível de contorno das colunas afetadas. O intervalo é de 0 a 7. Confira 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 W3C XML Schema unsignedByte .
fonético (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 booliano W3C XML Schema.
style (Style)	Estilo padrão para as colunas afetadas. Afeta células ainda não alocadas nas colunas. Em outras palavras, esse estilo se aplica a novas colunas. Os valores possíveis para esse atributo são definidos pelo tipo de dados W3C XML Schema unsignedInt .
largura (Largura da Coluna)	A largura da coluna medida como o número de caracteres da largura máxima do dígito dos números 0, 1, 2, ..., 9 renderizados na fonte do estilo normal. Há 4 pixels de preenchimento de margem (dois em cada lado), além de 1 pixel de preenchimento para as linhas de grade. width = Truncate([{Número de Caracteres} * {Largura máxima do dígito} + {5 pixel padding}]/{Largura máxima de dígito}*256)/256 [Exemplo: usando a fonte Calibri como exemplo, a largura máxima do dígito de 11 pontos de tamanho da fonte é 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 final] Para traduzir o valor da largura no arquivo no valor da largura da coluna no runtime (expresso em termos de pixels), use este cálculo: =Truncate(((256 * {width} + Truncate(128/{Largura máxima de dígito}))/256)*{Largura máxima de dígito}) [Exemplo: usando o mesmo exemplo que acima, o cálculo seria Truncate(((256*8.7109375+Truncate(128/7))/256)*7) = 61 pixels. exemplo final] Para traduzir de pixels para a largura do caractere, use este cálculo: =Truncate(({pixels}-5)/{Largura máxima de 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 final] [Observação: quando bordas largas são aplicadas, parte da borda esquerda/direita deve se sobrepor ao preenchimento de 2 pixels em cada lado. Bordas largas não afetam o cálculo de largura da coluna. nota final] [Observação: quando a folha está no modo para exibir fórmulas em vez de valores, a largura do pixel da coluna é duplicada. nota final] Os valores possíveis para esse atributo são definidos pelo tipo de dados duplo W3C XML Schema.

[Observação: a definição de esquema XML do W3C do modelo de conteúdo desse elemento (CT_Col) está localizada em §A.2. nota final]

ISO/IEC29500: 2008.

Construtores

Column()

Inicializa uma nova instância da classe Column.

Propriedades

BestFit	Largura da coluna de melhor ajuste Representa o seguinte atributo no esquema: bestFit
ChildElements	Obtém todos os nós filho 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. Retornará nulo (Nada no Visual Basic) se não houver 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 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. Retornará nulo (Nada no Visual Basic) se não houver esse elemento OpenXmlElement. (Herdado de OpenXmlElement)
LocalName	Obtém o nome local do elemento atual. (Herdado de OpenXmlElement)
Max	Coluna Máxima Representa o seguinte atributo no esquema: máximo
MCAttributes	Obtém ou define os atributos de compatibilidade de marcação. Retorna nulo se nenhum atributo de compatibilidade de marcação for definido para o elemento atual. (Herdado de OpenXmlElement)
Min	Coluna Mínima Representa o seguinte atributo no esquema: min
NamespaceDeclarations	Obtém todas as declarações de namespace definidas no elemento atual. Retornará 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 de contorno 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 namespace do elemento atual. (Herdado de OpenXmlElement)
Style	Estilo Representa o seguinte atributo no esquema: estilo
Width	Largura da coluna Representa o seguinte atributo no esquema: largura
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 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 até o final da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
AppendChild<T>(T)	Acrescenta o elemento especificado ao final da lista de nós filho 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>()	Enumera 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 e o URI do namespace especificados. (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 é exibido após um elemento especificado na ordem do documento. (Herdado de OpenXmlElement)
IsBefore(OpenXmlElement)	Determina se o elemento atual é exibido antes de um elemento especificado na ordem do documento. (Herdado de OpenXmlElement)
LookupNamespace(String)	Resolve o prefixo 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 nulo (Nada 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. Retornará nulo (Nada no Visual Basic) se não houver o 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 do prefixo especificado. Não removerá nada se não houver nenhum 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 um atributo 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 uma série de atributos para o elemento. Se um atributo for um atributo 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

IEnumerable.GetEnumerator()	Largura da coluna e formatação. Essa 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)