Column Clase

Definición

Espacio de nombres:

DocumentFormat.OpenXml.Spreadsheet

Ensamblado:

DocumentFormat.OpenXml.dll

Paquete:

DocumentFormat.OpenXml v3.0.1

Ancho y formato de columna.

Esta clase está disponible en Office 2007 y versiones posteriores.

Cuando el objeto se serializa como xml, su nombre completo es x:col.

public class Column : DocumentFormat.OpenXml.OpenXmlLeafElement

type Column = class
    inherit OpenXmlLeafElement

Public Class Column
Inherits OpenXmlLeafElement

Herencia

Object

OpenXmlElement

OpenXmlLeafElement

Column

Ejemplos

En el ejemplo siguiente se abre un documento de hoja de cálculo para el acceso de solo lectura. Al usar el nombre de la hoja de cálculo y el nombre de la celda, obtiene el nombre de columna y lo muestra.

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  

Comentarios

[ISO/IEC 29500-1 1.ª edición]

col (formato de & ancho de columna)

Define el ancho de columna y el formato de columna para una o varias columnas de la hoja de cálculo.

[Ejemplo:En este ejemplo se muestra que la columna 5 (E) tiene aplicada la información de ancho y estilo.

<col min="5" max="5" width="9.140625" style="3"/>  

Fin del ejemplo]

Elementos primarios
cols (§18.3.1.17)

Atributos	Descripción
bestFit (mejor ajuste de ancho de columna)	Marca que indica si las columnas especificadas están establecidas en "best fit". "Best fit" se establece en true en estas condiciones: - El usuario nunca ha establecido manualmente el ancho de columna, - El ancho de columna no es el ancho predeterminado - "Ajuste óptimo" significa que cuando los números se escriben en una celda contenida en una columna de "mejor ajuste", el ancho de columna debe cambiar automáticamente el tamaño para mostrar el número. [Nota: En los casos de mejor ajuste, el ancho de columna no debe ser más pequeño, solo mayor. Fin de la nota] El tipo de datos boolean del esquema XML W3C define los valores posibles para este atributo.
contraído (contraído)	Marca que indica si la esquematización de las columnas afectadas está en estado contraído. Consulte la descripción de los atributos summaryBelow y summaryRight del elemento de fila contraído y outlinePr para obtener información detallada. El tipo de datos boolean del esquema XML W3C define los valores posibles para este atributo.
customWidth (ancho personalizado)	Marca que indica que el ancho de columna de las columnas afectadas es diferente del valor predeterminado o se ha establecido manualmente. El tipo de datos boolean del esquema XML W3C define los valores posibles para este atributo.
hidden (columnas ocultas)	Marca que indica si las columnas afectadas están ocultas en esta hoja de cálculo. El tipo de datos boolean del esquema XML W3C define los valores posibles para este atributo.
max (columna máxima)	Última columna afectada por este registro de "información de columna". Los valores posibles para este atributo los define el tipo de datos unsignedInt del esquema XML W3C.
min (columna mínima)	Primera columna afectada por este registro de "información de columna". Los valores posibles para este atributo los define el tipo de datos unsignedInt del esquema XML W3C.
outlineLevel (nivel de esquema)	Nivel de esquema de las columnas afectadas. El intervalo es de 0 a 7. Consulte la descripción de los atributos summaryBelow y summaryRight del elemento outlinePr para obtener información detallada. Los valores posibles para este atributo se definen mediante el tipo de datos W3C XML Schema unsignedByte .
fonética (Mostrar información fonética)	Marca que indica si la información fonética debe mostrarse de forma predeterminada para las columnas afectadas de la hoja de cálculo. El tipo de datos boolean del esquema XML W3C define los valores posibles para este atributo.
style (Style)	Estilo predeterminado para las columnas afectadas. Afecta a las celdas que aún no se han asignado en las columnas. En otras palabras, este estilo se aplica a las nuevas columnas. Los valores posibles para este atributo los define el tipo de datos unsignedInt del esquema XML W3C.
width (Ancho de columna)	Ancho de columna medido como el número de caracteres del ancho de dígito máximo de los números 0, 1, 2, ..., 9 como se representa en la fuente del estilo normal. Hay 4 píxeles de relleno de margen (dos en cada lado), además de un relleno de 1 píxel para las líneas de cuadrícula. width = Truncate([{Number of Characters} * {Maximum Digit Width} + {5 pixel padding}]/{Maximum Digit Width}*256)/256 [Ejemplo: con la fuente Calibri como ejemplo, el ancho de dígito máximo de 11 puntos de tamaño de fuente es de 7 píxeles (a 96 ppp). De hecho, cada dígito es el mismo ancho para esta fuente. Por lo tanto, si el ancho de celda es de 8 caracteres, el valor de este atributo debe ser Truncate([8*7+5]/7*256)/256 = 8.7109375. Fin del ejemplo] Para traducir el valor de width en el archivo en el valor de ancho de columna en tiempo de ejecución (expresado en términos de píxeles), use este cálculo: =Truncate(((256 * {width} + Truncate(128/{Maximum Digit Width}))/256)*{Maximum Digit Width}) [Ejemplo: con el mismo ejemplo que anteriormente, el cálculo sería Truncate(((256*8.7109375+Truncate(128/7))/256)*7) = 61 píxeles. Fin del ejemplo] Para traducir de píxeles a ancho de caracteres, use este cálculo: =Truncate(({pixels}-5)/{Maximum Digit Width} * 100+0.5)/100 [Ejemplo: con el ejemplo anterior, el cálculo sería Truncate((61-5)/7*100+0.5)/100 = 8 caracteres. Fin del ejemplo] [Nota: cuando se aplican bordes anchos, parte del borde izquierdo/derecho debe superponerse con el relleno de 2 píxeles en cada lado. Los bordes anchos no afectan al cálculo del ancho de la columna. Fin de la nota] [Nota: Cuando la hoja está en el modo para ver fórmulas en lugar de valores, el ancho de píxel de la columna se duplica. Fin de la nota] Los valores posibles para este atributo se definen mediante el tipo de datos doble esquema XML de W3C.

[Nota: La definición del esquema XML W3C del modelo de contenido de este elemento (CT_Col) se encuentra en §A.2. Fin de la nota]

ISO/IEC29500: 2008.

Constructores

Column()

Inicializa una nueva instancia de la clase Column.

Propiedades

BestFit	Ajustar mejor el ancho de columna Representa el atributo siguiente en el esquema: bestFit
ChildElements	Obtiene todos los nodos secundarios del elemento actual. (Heredado de OpenXmlElement)
Collapsed	Collapsed Representa el atributo siguiente en el esquema: contraído
CustomWidth	Ancho personalizado Representa el atributo siguiente en el esquema: customWidth
ExtendedAttributes	Obtiene todos los atributos extendidos (atributos no definidos en el esquema) del elemento actual. (Heredado de OpenXmlElement)
Features	Obtiene un IFeatureCollection para el elemento actual. Esta colección de características será de solo lectura, pero heredará características de su elemento primario y paquete si está disponible. (Heredado de OpenXmlElement)
FirstChild	Obtiene el primer elemento secundario del elemento OpenXmlElement. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement de este tipo. (Heredado de OpenXmlElement)
HasAttributes	Obtiene un valor que indica si el elemento actual tiene atributos. (Heredado de OpenXmlElement)
HasChildren	Obtiene un valor que indica si el elemento actual tiene algún elemento secundario. (Heredado de OpenXmlLeafElement)
Hidden	Columnas ocultas Representa el atributo siguiente en el esquema: oculto
InnerText	Obtiene o establece los valores concatenados del nodo y todos sus elementos secundarios. (Heredado de OpenXmlElement)
InnerXml	Obtiene o establece el marcado que solo representa elementos secundarios del elemento actual. (Heredado de OpenXmlLeafElement)
LastChild	Obtiene el último elemento secundario del elemento OpenXmlElement. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement de este tipo. (Heredado de OpenXmlElement)
LocalName	Obtiene el nombre local del elemento actual. (Heredado de OpenXmlElement)
Max	Columna máxima Representa el atributo siguiente en el esquema: max
MCAttributes	Obtiene o establece los atributos de compatibilidad de marcado. Devuelve null si no se definen atributos de compatibilidad de marcado para el elemento actual. (Heredado de OpenXmlElement)
Min	Columna mínima Representa el atributo siguiente en el esquema: min
NamespaceDeclarations	Obtiene todas las declaraciones de espacio de nombres definidas en el elemento actual. Devuelve un enumerador vacío si no hay ninguna declaración de espacio de nombres. (Heredado de OpenXmlElement)
NamespaceUri	Obtiene el URI del espacio de nombres del elemento actual. (Heredado de OpenXmlElement)
OpenXmlElementContext	Obtiene el Objeto OpenXmlElementContext del elemento actual. (Heredado de OpenXmlElement)
OuterXml	Obtiene el marcado que representa el elemento actual y todos sus elementos secundarios. (Heredado de OpenXmlElement)
OutlineLevel	Nivel de esquema Representa el atributo siguiente en el esquema: outlineLevel
Parent	Obtiene el elemento primario del elemento actual. (Heredado de OpenXmlElement)
Phonetic	Mostrar información fonética Representa el atributo siguiente en el esquema: fonético
Prefix	Obtiene el prefijo de espacio de nombres del elemento actual. (Heredado de OpenXmlElement)
Style	Estilo Representa el atributo siguiente en el esquema: style
Width	Ancho de columna Representa el atributo siguiente en el esquema: width
XmlQualifiedName	Obtiene el nombre completo del elemento actual. (Heredado de OpenXmlElement)
XName	Obtiene el nombre completo del elemento actual. (Heredado de OpenXmlElement)

Métodos

AddAnnotation(Object)	Agrega un objeto a la lista de anotaciones del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
AddNamespaceDeclaration(String, String)	Agrega una declaración de espacio de nombres al nodo actual. (Heredado de OpenXmlElement)
Ancestors()	Enumera todos los antecesores del elemento actual. (Heredado de OpenXmlElement)
Ancestors<T>()	Enumera solo los antecesores del elemento actual que tienen el tipo especificado. (Heredado de OpenXmlElement)
Annotation(Type)	Obtenga el primer objeto de anotación del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Annotation<T>()	Obtenga el primer objeto de anotación del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Annotations(Type)	Obtiene una colección de anotaciones con el tipo especificado para el elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Annotations<T>()	Obtiene una colección de anotaciones con el tipo especificado para el elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Anexa cada elemento de una lista de elementos al final de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
Append(OpenXmlElement[])	Anexa cada elemento de una matriz de elementos al final de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
AppendChild<T>(T)	Anexa el elemento especificado al final de la lista de nodos secundarios del elemento actual. (Heredado de OpenXmlElement)
ClearAllAttributes()	Borra todos los atributos, incluidos los atributos conocidos y los atributos extendidos. (Heredado de OpenXmlElement)
Clone()	Crea un duplicado del nodo actual. (Heredado de OpenXmlElement)
CloneNode(Boolean)	Crea un duplicado de este nodo.
Descendants()	Enumera todos los descendientes del elemento actual. (Heredado de OpenXmlElement)
Descendants<T>()	Enumera todos los descendientes del elemento actual del tipo T. (Heredado de OpenXmlElement)
Elements()	Enumera todos los elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
Elements<T>()	Enumera solo los elementos secundarios del elemento actual que tienen el tipo especificado. (Heredado de OpenXmlElement)
ElementsAfter()	Enumera todos los elementos del mismo nivel que siguen el elemento actual y tienen el mismo elemento primario que el elemento actual. (Heredado de OpenXmlElement)
ElementsBefore()	Enumera todos los elementos del mismo nivel que preceden al elemento actual y tienen el mismo elemento primario que el elemento actual. (Heredado de OpenXmlElement)
GetAttribute(String, String)	Obtiene un atributo Open XML con el nombre de etiqueta y el URI de espacio de nombres especificados. (Heredado de OpenXmlElement)
GetAttributes()	Obtiene una lista que contiene una copia de todos los atributos. (Heredado de OpenXmlElement)
GetEnumerator()	Devuelve un enumerador que recorre en iteración la colección secundaria. (Heredado de OpenXmlElement)
GetFirstChild<T>()	Busca el primer elemento secundario en el tipo T. (Heredado de OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Inserta el elemento especificado inmediatamente después del elemento de referencia especificado. (Heredado de OpenXmlElement)
InsertAfterSelf<T>(T)	Inserta el elemento especificado inmediatamente después del elemento actual. (Heredado de OpenXmlElement)
InsertAt<T>(T, Int32)	Inserta el elemento especificado en el índice especificado en la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
InsertBefore<T>(T, OpenXmlElement)	Inserta el elemento especificado inmediatamente antes del elemento de referencia especificado. (Heredado de OpenXmlElement)
InsertBeforeSelf<T>(T)	Inserta el elemento especificado inmediatamente antes del elemento actual. (Heredado de OpenXmlElement)
IsAfter(OpenXmlElement)	Determina si el elemento actual aparece después de un elemento especificado en el orden del documento. (Heredado de OpenXmlElement)
IsBefore(OpenXmlElement)	Determina si el elemento actual aparece antes que un elemento especificado en el orden del documento. (Heredado de OpenXmlElement)
LookupNamespace(String)	Resuelve el prefijo de espacio de nombres en el contexto del nodo actual. (Heredado de OpenXmlElement)
LookupPrefix(String)	Busca el prefijo correspondiente para un uri de espacio de nombres en el ámbito del elemento actual. (Heredado de OpenXmlElement)
NextSibling()	Obtiene el elemento OpenXmlElement que sigue inmediatamente al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement siguiente. (Heredado de OpenXmlElement)
NextSibling<T>()	Obtiene el elemento OpenXmlElement con el tipo especificado que sigue al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement siguiente. (Heredado de OpenXmlElement)
PrependChild<T>(T)	Inserta el elemento especificado al principio de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
PreviousSibling()	Obtiene el elemento OpenXmlElement que precede inmediatamente al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic ) si no hay ningún elemento OpenXmlElement anterior. (Heredado de OpenXmlElement)
PreviousSibling<T>()	Obtiene el elemento OpenXmlElement con el tipo especificado que precede al objeto OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement anterior. (Heredado de OpenXmlElement)
Remove()	Quita el elemento actual de su elemento primario. (Heredado de OpenXmlElement)
RemoveAllChildren()	Quita todos los elementos secundarios del elemento actual. (Heredado de OpenXmlLeafElement)
RemoveAllChildren<T>()	Quite todos los elementos secundarios del elemento actual que son de tipo T. (Heredado de OpenXmlElement)
RemoveAnnotations(Type)	Quita las anotaciones del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
RemoveAnnotations<T>()	Quita las anotaciones con el tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
RemoveAttribute(String, String)	Quita el atributo del elemento actual. (Heredado de OpenXmlElement)
RemoveChild<T>(T)	Quita el elemento secundario especificado de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
RemoveNamespaceDeclaration(String)	Quita la declaración de espacio de nombres para el prefijo especificado. No quita nada si no hay ningún prefijo. (Heredado de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Reemplaza un elemento secundario por otro elemento secundario en la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
SetAttribute(OpenXmlAttribute)	Establece un atributo en el elemento especificado. Si el atributo es un atributo conocido, se establece el valor del atributo. Si el atributo es un atributo extendido, el atributo "openxmlAttribute" se agrega a la lista de atributos extendidos. (Heredado de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Establece una serie de atributos en el elemento . Si un atributo es un atributo conocido, se establece el valor del atributo. Si un atributo es un atributo extendido, el atributo "openxmlAttribute" se agrega a la lista de atributos extendidos. (Heredado de OpenXmlElement)
WriteTo(XmlWriter)	Guarda el nodo actual en el objeto XmlWriter especificado. (Heredado de OpenXmlElement)

Implementaciones de interfaz explícitas

IEnumerable.GetEnumerator()	Ancho y formato de columna. Esta clase está disponible en Office 2007 y versiones posteriores. Cuando el objeto se serializa como xml, su nombre completo es x:col. (Heredado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Devuelve un enumerador que recorre en iteración la colección secundaria. (Heredado de OpenXmlElement)