Column Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.
[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- Héritage
- Héritage
- Attributs
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 |
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. |
| 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) |
S’applique à
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour