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 de Colunas.
Esta classe está disponível no Office 2007 e superior.
Quando o objeto é serializado como xml, o 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 seguinte abre um documento de folha de cálculo para acesso só de leitura. Ao utilizar o nome da folha de cálculo e o nome da célula, obtém o nome da coluna e apresenta-o.
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 das colunas e a formatação de colunas para uma ou mais colunas da folha de cálculo.
[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 |
|---|
| colunas (}18.3.1.17) |
| Atributos | Descrição |
|---|---|
| bestFit (Melhor Ajustar Largura da Coluna) | Sinalizador que indica se as colunas especificadas estão definidas como "melhor ajuste". A opção "Melhor ajuste" está definida como verdadeira nestas condições: - A largura da coluna nunca foi definida manualmente pelo utilizador, - A largura da coluna não é a largura predefinida - "Melhor ajuste" significa que, quando os números são escritos numa célula contida numa coluna de "melhor ajuste", a largura da coluna deve ser redimensionada automaticamente para apresentar o número. [Nota: nos casos mais adequados, a largura das colunas não pode ser mais pequena, apenas maior. nota de fim] Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C. |
| fechado (Fechado) | Sinalizador que indica se o destaque das colunas afetadas está no estado fechado. Veja a descrição dos atributos summaryBelow e summaryRight do elemento outlined e outlinePr para obter informações detalhadas. Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C. |
| customWidth (Largura Personalizada) | Sinalizador que indica que a largura da coluna para as colunas afetadas é diferente da predefinição ou foi definida manualmente. Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C. |
| oculto (Colunas Ocultas) | Sinalizador que indica se as colunas afetadas estão ocultas nesta folha de cálculo. Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C. |
| máx. (Coluna Máxima) | Última coluna afetada por este registo de "informações da coluna". Os valores possíveis para este atributo são definidos pelo tipo de dados W3C XML Schema unsignedInt . |
| min (Coluna Mínima) | Primeira coluna afetada por este registo de "informações da coluna". Os valores possíveis para este atributo são definidos pelo tipo de dados W3C XML Schema unsignedInt . |
| outlineLevel (Nível hierárquico) | Nível hierárquico das colunas afetadas. O intervalo é de 0 a 7. Veja a descrição dos atributos summaryBelow e summaryRight do elemento outlinePr para obter informações detalhadas. Os valores possíveis para este atributo são definidos pelo tipo de dados Esquema XML W3C unsignedByte . |
| fonético (Mostrar Informações Fonéticas) | Sinalizador que indica se as informações fonéticas devem ser apresentadas por predefinição para as colunas afetadas da folha de cálculo. Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C. |
| estilo (Estilo) | Estilo predefinido para as colunas afetadas. Afeta as células ainda não alocadas nas colunas. Por outras palavras, este estilo aplica-se a novas colunas. Os valores possíveis para este atributo são definidos pelo tipo de dados W3C XML Schema unsignedInt . |
| largura (Largura da Coluna) | Largura da coluna medida como o número de carateres da largura máxima do dígito dos números 0, 1, 2, ..., 9 conforme apresentado no tipo de letra do estilo normal. Existem 4 píxeis de preenchimento de margem (dois de cada lado), mais 1 píxel de preenchimento para as linhas de grelha. width = Truncate([{Number of Characters} * {Maximum Digit Width} + {5 pixel padding}]/{Maximum Digit Width}*256)/256 [Exemplo: ao utilizar o tipo de letra Calibri como exemplo, a largura máxima do dígito de tamanho do tipo de letra de 11 pontos é de 7 píxeis (a 96 ppp). Na verdade, cada dígito tem a mesma largura para este tipo de letra. Portanto, se a largura da célula tiver 8 carateres de largura, o valor deste atributo tem de ser Truncado([8*7+5]/7*256)/256 = 8,7109375. exemplo final] Para traduzir o valor da largura no ficheiro para o valor de largura da coluna no runtime (expresso em termos de píxeis), utilize este cálculo: =Truncar(((256 * {width} + Truncate(128/{Maximum Digit Width}))/256)*{Maximum Digit Width}) [Exemplo: ao utilizar o mesmo exemplo acima, o cálculo seria Truncar(((256*8,7109375+Truncate(128/7))/256)*7) = 61 pixels. exemplo final] Para traduzir de píxeis para largura de carateres, utilize este cálculo: =Truncar(({pixels}-5)/{Largura Máxima do Dígito} * 100+0,5)/100 [Exemplo: ao utilizar o exemplo acima, o cálculo seria Truncar((61-5)/7*100+0,5)/100 = 8 carateres. exemplo final] [Nota: quando são aplicados limites largos, parte do limite esquerdo/direito tem de se sobrepor ao preenchimento de 2 píxeis de cada lado. Os limites largos não afetam o cálculo da largura da coluna. nota de fim] [Nota: quando a folha está no modo para ver fórmulas em vez de valores, a largura dos píxeis da coluna é duplicada. nota de fim] Os valores possíveis para este atributo são definidos pelo tipo de dados duplo Esquema XML W3C. |
[Nota: a definição de Esquema XML W3C do modelo de conteúdo deste elemento (CT_Col) está localizada em {A.2. nota de fim]
ISO/IEC29500: 2008.
Construtores
| Column() |
Inicializa uma nova instância da classe Coluna. |
Propriedades
| BestFit |
Ajustar Melhor Largura da Coluna Representa o seguinte atributo no esquema: bestFit |
| ChildElements |
Obtém todos os nós subordinados do elemento atual. (Herdado de OpenXmlElement) |
| Collapsed |
Recolhido Representa o seguinte atributo no esquema: fechado |
| CustomWidth |
Largura Personalizada Representa o seguinte atributo no esquema: customWidth |
| 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 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 respetivos subordinados. (Herdado de OpenXmlElement) |
| InnerXml |
Obtém ou define a marcação que representa apenas elementos subordinados do elemento atual. (Herdado de OpenXmlLeafElement) |
| 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 |
Largura e Formatação de Colunas. Esta classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, o nome qualificado é x:col. |
| LocalName |
Obtém o nome local do elemento atual. (Herdado de OpenXmlElement) |
| Max |
Coluna Máxima Representa o seguinte atributo no esquema: máx. |
| 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) |
| Min |
Coluna Mínima Representa o seguinte atributo no esquema: min |
| 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) |
| OutlineLevel |
Nível Hierárquico Representa o seguinte atributo no esquema: outlineLevel |
| Parent |
Obtém o elemento principal 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 de espaço de nomes do elemento atual. (Herdado de OpenXmlElement) |
| Style |
Style Representa o seguinte atributo no estilo schema: |
| 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 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 OpenXmlLeafElement) |
| 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) |
| WriteTo(XmlWriter) |
Guarda o nó atual no XmlWriter especificado. (Herdado de OpenXmlElement) |
Implantações explícitas de interface
| IEnumerable.GetEnumerator() |
Largura e Formatação de Colunas. Esta classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, o nome qualificado é x:col. (Herdado de OpenXmlElement) |
| IEnumerable<OpenXmlElement>.GetEnumerator() |
Devolve um enumerador que itera através da coleção subordinada. (Herdado de OpenXmlElement) |