Column Classe

Définition

Espace de noms:

DocumentFormat.OpenXml.Spreadsheet

Assembly:

DocumentFormat.OpenXml.dll

Paquet:

DocumentFormat.OpenXml v3.0.1

Largeur et mise en forme des colonnes.

Cette classe est disponible dans Office 2007 et versions ultérieures.

Lorsque l’objet est sérialisé au format xml, son nom qualifié est x :col.

public class Column : DocumentFormat.OpenXml.OpenXmlLeafElement

type Column = class
    inherit OpenXmlLeafElement

Public Class Column
Inherits OpenXmlLeafElement

Héritage

Object

OpenXmlElement

OpenXmlLeafElement

Column

Exemples

L’exemple suivant ouvre un document de feuille de calcul pour un accès en lecture seule. En utilisant le nom de la feuille de calcul et le nom de la cellule, elle obtient le nom de la colonne et l’affiche.

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  

Remarques

[ISO/IEC 29500-1 1st Edition]

col (largeur de colonne & mise en forme)

Définit la largeur des colonnes et la mise en forme de colonne pour une ou plusieurs colonnes de la feuille de calcul.

[Exemple : Cet exemple montre que les informations de largeur et de style appliquées à la colonne 5 (E) sont appliquées.

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

Fin de l’exemple]

Éléments parents
cols (§18.3.1.17)

Attributs	Description
bestFit (meilleure largeur de colonne d’ajustement)	Indicateur indiquant si la ou les colonnes spécifiées sont définies sur « meilleur ajustement ». 'Best Fit' est défini sur true dans les conditions suivantes : - La largeur de colonne n’a jamais été définie manuellement par l’utilisateur, - La largeur de colonne n’est pas la largeur par défaut - « Meilleur ajustement » signifie que lorsque des nombres sont tapés dans une cellule contenue dans une colonne « meilleur ajustement », la largeur de colonne doit automatiquement être redimensionnée pour afficher le nombre. [Remarque : Dans les meilleurs cas, la largeur de colonne ne doit pas être réduite, mais seulement plus grande. Fin de la remarque] Les valeurs possibles de cet attribut sont définies par le type de données boolean du schéma W3C XML.
collapsed (Collapsed)	Indicateur indiquant si le plan des colonnes affectées est à l’état réduit. Consultez la description des attributs summaryBelow et summaryRight de l’élément row collapsed et outlinePr pour plus d’informations. Les valeurs possibles de cet attribut sont définies par le type de données boolean du schéma W3C XML.
customWidth (Largeur personnalisée)	Indicateur indiquant que la largeur de colonne pour la ou les colonnes affectées est différente de la valeur par défaut ou a été définie manuellement. Les valeurs possibles de cet attribut sont définies par le type de données boolean du schéma W3C XML.
hidden (Hidden Columns)	Indicateur indiquant si la ou les colonnes affectées sont masquées dans cette feuille de calcul. Les valeurs possibles de cet attribut sont définies par le type de données boolean du schéma W3C XML.
max (colonne maximale)	Dernière colonne affectée par cet enregistrement « column info ». Les valeurs possibles de cet attribut sont définies par le type de données unsignedInt du schéma XML du W3C.
min (colonne minimale)	Première colonne affectée par cet enregistrement « column info ». Les valeurs possibles de cet attribut sont définies par le type de données unsignedInt du schéma XML du W3C.
outlineLevel (niveau hiérarchique)	Niveau hiérarchique de la ou des colonnes affectées. La plage est comprise entre 0 et 7. Pour plus d’informations, consultez la description des attributs summaryBelow et summaryRight de l’élément outlinePr. Les valeurs possibles pour cet attribut sont définies par le type de données unsignedByte du schéma XML W3C.
phonétique (Afficher les informations phonétiques)	Indicateur indiquant si les informations phonétiques doivent être affichées par défaut pour la ou les colonnes affectées de la feuille de calcul. Les valeurs possibles de cet attribut sont définies par le type de données boolean du schéma W3C XML.
style (Style)	Style par défaut pour la ou les colonnes affectées. Affecte les cellules qui ne sont pas encore allouées dans la ou les colonnes. En d’autres termes, ce style s’applique aux nouvelles colonnes. Les valeurs possibles de cet attribut sont définies par le type de données unsignedInt du schéma XML du W3C.
width (Largeur de colonne)	Largeur de colonne mesurée en tant que nombre de caractères de la largeur de chiffre maximale des nombres 0, 1, 2, ..., 9 tels que rendus dans la police du style normal. Il y a 4 pixels de remplissage de marge (deux de chaque côté), plus 1 pixel de remplissage pour le quadrillage. width = Truncate([{Number of Characters} * {Maximum Digit Width} + {5 pixels padding}]/{Maximum Digit Width}*256)/256 [Exemple : En utilisant la police Calibri comme exemple, la largeur maximale des chiffres d’une taille de police de 11 points est de 7 pixels (à 96 ppp). En fait, chaque chiffre a la même largeur pour cette police. Par conséquent, si la largeur de cellule est de 8 caractères, la valeur de cet attribut doit être Truncate([8*7+5]/7*256)/256 = 8,7109375. Fin de l’exemple] Pour traduire la valeur de largeur dans le fichier en valeur de largeur de colonne au moment de l’exécution (exprimée en pixels), utilisez ce calcul : =Truncate((((256 * {width} + Truncate(128/{Maximum Digit Width}))/256)*{Maximum Digit Width}) [Exemple : En utilisant le même exemple que ci-dessus, le calcul serait Truncate(((256*8.7109375+Truncate(128/7))/256)*7) = 61 pixels. Fin de l’exemple] Pour traduire de pixels en largeur de caractères, utilisez ce calcul : =Truncate(({pixels}-5)/{Maximum Digit Width} * 100+0.5)/100 [Exemple : À l’aide de l’exemple ci-dessus, le calcul serait Truncate((61-5)/7*100+0.5)/100 = 8 caractères. Fin de l’exemple] [Remarque : lorsque des bordures larges sont appliquées, une partie de la bordure gauche/droite doit chevaucher le remplissage de 2 pixels de chaque côté. Les bordures larges n’affectent pas le calcul de la largeur de la colonne. Fin de la remarque] [Remarque : Lorsque la feuille est en mode d’affichage des formules au lieu des valeurs, la largeur en pixels de la colonne est doublée. Fin de la remarque] Les valeurs possibles pour cet attribut sont définies par le type de données double schéma XML W3C.

[Remarque : La définition de schéma XML W3C du modèle de contenu (CT_Col) de cet élément se trouve dans §A.2. Fin de la remarque]

ISO/IEC29500 : 2008.

Constructeurs

Column()

Initialise une nouvelle instance de la classe Column.

Propriétés

BestFit	Meilleure ajustement de la largeur de colonne Représente l’attribut suivant dans le schéma : bestFit
ChildElements	Obtient tous les nœuds enfants de l’élément actuel. (Hérité de OpenXmlElement)
Collapsed	Collapsed Représente l’attribut suivant dans le schéma : réduit
CustomWidth	Largeur personnalisée Représente l’attribut suivant dans le schéma : customWidth
ExtendedAttributes	Obtient tous les attributs étendus (attributs non définis dans le schéma) de l’élément actuel. (Hérité de OpenXmlElement)
Features	Obtient un IFeatureCollection pour l’élément actuel. Cette collection de fonctionnalités sera en lecture seule, mais héritera des fonctionnalités de sa partie parente et de son package, le cas échéant. (Hérité de OpenXmlElement)
FirstChild	Obtient le premier enfant de l’élément OpenXmlElement. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement de ce type. (Hérité de OpenXmlElement)
HasAttributes	Obtient une valeur indiquant si l’élément actuel a des attributs. (Hérité de OpenXmlElement)
HasChildren	Obtient une valeur qui indique si l’élément actuel a des éléments enfants. (Hérité de OpenXmlLeafElement)
Hidden	Colonnes masquées Représente l’attribut suivant dans le schéma : hidden
InnerText	Obtient ou définit les valeurs concaténées du nœud et de tous ses enfants. (Hérité de OpenXmlElement)
InnerXml	Obtient ou définit le balisage qui représente uniquement les éléments enfants de l’élément actuel. (Hérité de OpenXmlLeafElement)
LastChild	Obtient le dernier enfant de l’élément OpenXmlElement. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement de ce type. (Hérité de OpenXmlElement)
LocalName	Obtient le nom local de l’élément actuel. (Hérité de OpenXmlElement)
Max	Colonne maximale Représente l’attribut suivant dans le schéma : max
MCAttributes	Obtient ou définit les attributs de compatibilité du balisage. Retourne null si aucun attribut de compatibilité de balisage n’est défini pour l’élément actuel. (Hérité de OpenXmlElement)
Min	Colonne minimale Représente l’attribut suivant dans le schéma : min
NamespaceDeclarations	Obtient toutes les déclarations d’espace de noms définies dans l’élément actuel. Retourne un énumérateur vide s’il n’y a pas de déclaration d’espace de noms. (Hérité de OpenXmlElement)
NamespaceUri	Obtient l’URI d’espace de noms de l’élément actuel. (Hérité de OpenXmlElement)
OpenXmlElementContext	Obtient l’élément OpenXmlElementContext de l’élément actuel. (Hérité de OpenXmlElement)
OuterXml	Obtient le balisage qui représente l’élément actuel et tous ses éléments enfants. (Hérité de OpenXmlElement)
OutlineLevel	Niveau hiérarchique Représente l’attribut suivant dans le schéma : outlineLevel
Parent	Obtient l’élément parent de l’élément actuel. (Hérité de OpenXmlElement)
Phonetic	Afficher les informations phonétiques Représente l’attribut suivant dans le schéma : phonétique
Prefix	Obtient le préfixe d’espace de noms de l’élément actuel. (Hérité de OpenXmlElement)
Style	Style Représente l’attribut suivant dans le schéma : style
Width	Largeur de colonne Représente l’attribut suivant dans le schéma : width
XmlQualifiedName	Obtient le nom qualifié de l’élément actuel. (Hérité de OpenXmlElement)
XName	Obtient le nom qualifié de l’élément actuel. (Hérité de OpenXmlElement)

Méthodes

AddAnnotation(Object)	Ajoute un objet à la liste d’annotations de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
AddNamespaceDeclaration(String, String)	Ajoute une déclaration d’espace de noms au nœud actuel. (Hérité de OpenXmlElement)
Ancestors()	Énumère tous les ancêtres de l’élément actuel. (Hérité de OpenXmlElement)
Ancestors<T>()	Énumère uniquement les ancêtres de l’élément actuel qui ont le type spécifié. (Hérité de OpenXmlElement)
Annotation(Type)	Obtenez le premier objet d’annotation du type spécifié à partir de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
Annotation<T>()	Obtenez le premier objet d’annotation du type spécifié à partir de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
Annotations(Type)	Obtient une collection d’annotations avec le type spécifié pour l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
Annotations<T>()	Obtient une collection d’annotations avec le type spécifié pour l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Ajoute chaque élément d’une liste d’éléments à la fin de la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement)
Append(OpenXmlElement[])	Ajoute chaque élément d’un tableau d’éléments à la fin de la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement)
AppendChild<T>(T)	Ajoute l’élément spécifié à la fin de la liste des nœuds enfants de l’élément actuel. (Hérité de OpenXmlElement)
ClearAllAttributes()	Efface tous les attributs, y compris les attributs connus et les attributs étendus. (Hérité de OpenXmlElement)
Clone()	Crée un doublon du nœud actuel. (Hérité de OpenXmlElement)
CloneNode(Boolean)	Crée un doublon de ce nœud.
Descendants()	Énumère tous les descendants de l’élément actuel. (Hérité de OpenXmlElement)
Descendants<T>()	Énumérez tous les descendants de l’élément actuel de type T. (Hérité de OpenXmlElement)
Elements()	Énumère tous les enfants de l’élément actuel. (Hérité de OpenXmlElement)
Elements<T>()	Énumère uniquement les enfants de l’élément actuel qui ont le type spécifié. (Hérité de OpenXmlElement)
ElementsAfter()	Énumère tous les éléments frères qui suivent l’élément actuel et ont le même parent que l’élément actuel. (Hérité de OpenXmlElement)
ElementsBefore()	Énumère tous les éléments frères qui précèdent l’élément actuel et ont le même parent que l’élément actuel. (Hérité de OpenXmlElement)
GetAttribute(String, String)	Obtient un attribut Open XML avec le nom de balise et l’URI d’espace de noms spécifiés. (Hérité de OpenXmlElement)
GetAttributes()	Obtient une liste qui contient une copie de tous les attributs. (Hérité de OpenXmlElement)
GetEnumerator()	Retourne un énumérateur qui itère au sein de la collection enfant. (Hérité de OpenXmlElement)
GetFirstChild<T>()	Recherche le premier élément enfant de type T. (Hérité de OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Insère l’élément spécifié immédiatement après l’élément de référence spécifié. (Hérité de OpenXmlElement)
InsertAfterSelf<T>(T)	Insère l’élément spécifié immédiatement après l’élément actuel. (Hérité de OpenXmlElement)
InsertAt<T>(T, Int32)	Insère l’élément spécifié à l’index spécifié dans la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement)
InsertBefore<T>(T, OpenXmlElement)	Insère l’élément spécifié juste avant l’élément de référence spécifié. (Hérité de OpenXmlElement)
InsertBeforeSelf<T>(T)	Insère l’élément spécifié juste avant l’élément actuel. (Hérité de OpenXmlElement)
IsAfter(OpenXmlElement)	Détermine si l’élément actuel apparaît après un élément spécifié dans l’ordre du document. (Hérité de OpenXmlElement)
IsBefore(OpenXmlElement)	Détermine si l’élément actuel apparaît avant un élément spécifié dans l’ordre du document. (Hérité de OpenXmlElement)
LookupNamespace(String)	Résout le préfixe d’espace de noms dans le contexte du nœud actuel. (Hérité de OpenXmlElement)
LookupPrefix(String)	Recherche le préfixe correspondant pour un URI d’espace de noms dans l’étendue de l’élément actuel. (Hérité de OpenXmlElement)
NextSibling()	Obtient l’élément OpenXmlElement qui suit immédiatement l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement suivant. (Hérité de OpenXmlElement)
NextSibling<T>()	Obtient l’élément OpenXmlElement avec le type spécifié qui suit l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’y a pas d’élément OpenXmlElement suivant. (Hérité de OpenXmlElement)
PrependChild<T>(T)	Insère l’élément spécifié au début de la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement)
PreviousSibling()	Obtient l’élément OpenXmlElement qui précède immédiatement l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic ) s’il n’existe aucun élément OpenXmlElement précédent. (Hérité de OpenXmlElement)
PreviousSibling<T>()	Obtient l’élément OpenXmlElement avec le type spécifié qui précède l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement précédent. (Hérité de OpenXmlElement)
Remove()	Supprime l’élément actuel de son parent. (Hérité de OpenXmlElement)
RemoveAllChildren()	Supprime tous les éléments enfants de l’élément actuel. (Hérité de OpenXmlLeafElement)
RemoveAllChildren<T>()	Supprimez tous les éléments enfants de l’élément actuel qui sont de type T. (Hérité de OpenXmlElement)
RemoveAnnotations(Type)	Supprime les annotations du type spécifié de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
RemoveAnnotations<T>()	Supprime les annotations avec le type spécifié de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
RemoveAttribute(String, String)	Supprime l’attribut de l’élément actuel. (Hérité de OpenXmlElement)
RemoveChild<T>(T)	Supprime l’élément enfant spécifié de la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement)
RemoveNamespaceDeclaration(String)	Supprime la déclaration d’espace de noms pour le préfixe spécifié. Ne supprime rien s’il n’y a pas de préfixe. (Hérité de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Remplace un élément enfant par un autre élément enfant dans la liste d’éléments enfants de l’élément actuel. (Hérité de OpenXmlElement)
SetAttribute(OpenXmlAttribute)	Définit un attribut sur l’élément spécifié. Si l’attribut est un attribut connu, la valeur de l’attribut est définie. Si l’attribut est un attribut étendu, l’attribut « openxmlAttribute » est ajouté à la liste des attributs étendus. (Hérité de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Définit un certain nombre d’attributs à l’élément . Si un attribut est un attribut connu, la valeur de l’attribut est définie. Si un attribut est un attribut étendu, l’attribut « openxmlAttribute » est ajouté à la liste des attributs étendus. (Hérité de OpenXmlElement)
WriteTo(XmlWriter)	Enregistre le nœud actuel dans le XmlWriter spécifié. (Hérité de OpenXmlElement)

Implémentations d’interfaces explicites

IEnumerable.GetEnumerator()	Largeur et mise en forme des colonnes. Cette classe est disponible dans Office 2007 et versions ultérieures. Lorsque l’objet est sérialisé au format xml, son nom qualifié est x :col. (Hérité de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Retourne un énumérateur qui itère au sein de la collection enfant. (Hérité de OpenXmlElement)