Column Klasse

Definition

Namespace:

DocumentFormat.OpenXml.Spreadsheet

Assembly:

DocumentFormat.OpenXml.dll

Paket:

DocumentFormat.OpenXml v3.0.1

Spaltenbreite und -formatierung.

Diese Klasse ist in Office 2007 und höher verfügbar.

Wenn das Objekt als xml serialisiert wird, lautet der qualifizierte Name x:col.

public class Column : DocumentFormat.OpenXml.OpenXmlLeafElement

type Column = class
    inherit OpenXmlLeafElement

Public Class Column
Inherits OpenXmlLeafElement

Vererbung

Object

OpenXmlElement

OpenXmlLeafElement

Column

Beispiele

Im folgenden Beispiel wird ein Tabellenkalkulationsdokument für schreibgeschützten Zugriff geöffnet. Mithilfe des Arbeitsblattnamens und des Zellennamens wird der Spaltenname abgerufen und angezeigt.

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  

Hinweise

[ISO/IEC 29500-1 1. Auflage]

col (Spaltenbreite & Formatierung)

Definiert Spaltenbreite und Spaltenformatierung für eine oder mehrere Spalten des Arbeitsblatts.

[Beispiel:Dieses Beispiel zeigt, dass für Spalte 5 (E) Breite- und Formatinformationen angewendet werden.

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

Ende des Beispiels]

Übergeordnete Elemente
cols (§18.3.1.17)

Attribute	Beschreibung
bestFit (Optimale Spaltenbreite)	Flag, das angibt, ob die angegebenen Spalten auf "best fit" festgelegt sind. "Best fit" wird unter den folgenden Bedingungen auf TRUE festgelegt: - Die Spaltenbreite wurde noch nie manuell vom Benutzer festgelegt, – Die Spaltenbreite ist nicht die Standardbreite. - "Beste Anpassung" bedeutet, dass beim Eingeben von Zahlen in eine Zelle, die in einer Spalte mit der besten Anpassung enthalten ist, die Spaltenbreite automatisch geändert werden sollte, um die Zahl anzuzeigen. [Hinweis: In best fit-Fällen darf die Spaltenbreite nicht kleiner, nur größer sein. Ende des Hinweises] Die möglichen Werte für dieses Attribut sind durch den boolean-Datentyp des W3C XML-Schemas definiert.
reduziert (reduziert)	Flag, das angibt, ob sich die Gliederung der betroffenen Spalten im reduzierten Zustand befindet. Ausführliche Informationen finden Sie unter Beschreibung der Attribute "Collapsed" und "summaryBelow" und "summaryRight" des outlinePr-Elements. Die möglichen Werte für dieses Attribut sind durch den boolean-Datentyp des W3C XML-Schemas definiert.
customWidth (Benutzerdefinierte Breite)	Flag, das angibt, dass sich die Spaltenbreite für die betroffenen Spalten von der Standardspalte unterscheidet oder manuell festgelegt wurde. Die möglichen Werte für dieses Attribut sind durch den boolean-Datentyp des W3C XML-Schemas definiert.
hidden (Ausgeblendete Spalten)	Flag, das angibt, ob die betroffenen Spalten auf diesem Arbeitsblatt ausgeblendet sind. Die möglichen Werte für dieses Attribut sind durch den boolean-Datentyp des W3C XML-Schemas definiert.
max (Maximale Spalte)	Letzte Spalte, die von diesem Datensatz "Spalteninformationen" betroffen ist. Die möglichen Werte dieses Attributs werden durch den unsignedInt-Datentyp des W3C-XML-Schemas definiert.
min (Mindestspalte)	Erste Spalte, die von diesem Datensatz "Spalteninformationen" betroffen ist. Die möglichen Werte dieses Attributs werden durch den unsignedInt-Datentyp des W3C-XML-Schemas definiert.
outlineLevel (Gliederungsebene)	Gliederungsebene der betroffenen Spalten. Der Bereich ist 0 bis 7. Ausführliche Informationen finden Sie in der Beschreibung der Attribute summaryBelow und summaryRight des outlinePr-Elements. Die möglichen Werte für dieses Attribut werden durch den W3C XML Schema unsignedByte-Datentyp definiert.
phonetisch (Phonetische Informationen anzeigen)	Flag, das angibt, ob die phonetischen Informationen standardmäßig für die betroffenen Spalten des Arbeitsblatts angezeigt werden sollen. Die möglichen Werte für dieses Attribut sind durch den boolean-Datentyp des W3C XML-Schemas definiert.
style (Style)	Standardformat für die betroffenen Spalten. Wirkt sich auf Zellen aus, die noch nicht in den Spalten zugeordnet sind. Anders ausgedrückt: Dieser Stil gilt für neue Spalten. Die möglichen Werte dieses Attributs werden durch den unsignedInt-Datentyp des W3C-XML-Schemas definiert.
width (Spaltenbreite)	Spaltenbreite gemessen als Anzahl von Zeichen der maximalen Ziffernbreite der Zahlen 0, 1, 2, ..., 9, wie in der Schriftart des normalen Stils gerendert. Es gibt 4 Pixel Randabstand (zwei auf jeder Seite), plus 1 Pixel Abstand für die Gitternetzlinien. width = Abgeschnitten([{Anzahl von Zeichen} * {Maximale Ziffernbreite} + {5 Pixel Abstand}]/{Maximale Ziffernbreite}*256)/256 [Beispiel: Bei Verwendung der Schriftart Calibri beträgt die maximale Ziffernbreite von 11 Punkt Schriftgrad 7 Pixel (bei 96 dpi). Tatsächlich hat jede Ziffer die gleiche Breite für diese Schriftart. Wenn die Zellbreite also 8 Zeichen breit ist, muss der Wert dieses Attributs Truncate([8*7+5]/7*256)/256 = 8,7109375 sein. Ende des Beispiels] Verwenden Sie die folgende Berechnung, um den Wert der Breite in der Datei zur Laufzeit in den Spaltenbreitenwert (ausgedrückt in Pixeln) zu übersetzen: =Abschneiden(((256 * {width} + Abschneiden(128/{Maximale Ziffernbreite})/256)*{Maximale Ziffernbreite}) [Beispiel: Wenn Sie dasselbe Beispiel wie oben verwenden, würde die Berechnung Abschneiden((256*8.7109375+Truncate(128/7))/256)*7) = 61 Pixel sein. Ende des Beispiels] Verwenden Sie diese Berechnung, um von Pixeln in Zeichenbreite zu übersetzen: =Abschneiden(({pixels}-5)/{Maximale Ziffernbreite} * 100+0,5)/100 [Beispiel: Bei Verwendung des obigen Beispiels lautet die Berechnung Abschneiden((61-5)/7*100+0,5)/100 = 8 Zeichen. Ende des Beispiels] [Hinweis: Wenn breite Rahmen angewendet werden, muss sich ein Teil des linken/rechten Rahmens mit dem Abstand von 2 Pixeln auf jeder Seite überlappen. Breite Rahmen wirken sich nicht auf die Breitenberechnung der Spalte aus. Ende des Hinweises] [Hinweis: Wenn sich das Blatt im Modus zum Anzeigen von Formeln anstelle von Werten befindet, wird die Pixelbreite der Spalte verdoppelt. Ende des Hinweises] Die möglichen Werte für dieses Attribut werden durch den doppelten W3C XML Schema-Datentyp definiert.

[Hinweis: Die W3C-XML-Schemadefinition des Inhaltsmodells (CT_Col) dieses Elements befindet sich in §A.2. Ende des Hinweises]

ISO/IEC29500: 2008.

Konstruktoren

Column()

Initialisiert eine neue instance der Column-Klasse.

Eigenschaften

BestFit	Breite der am besten geeigneten Spalte Stellt das folgende Attribut im Schema dar: bestFit
ChildElements	Ruft alle untergeordneten Knoten des aktuellen Elements ab. (Geerbt von OpenXmlElement)
Collapsed	Collapsed Stellt das folgende Attribut im Schema dar: collapsed
CustomWidth	Benutzerdefinierte Breite Stellt das folgende Attribut im Schema dar: customWidth
ExtendedAttributes	Ruft alle erweiterten Attribute (Attribute, die im Schema nicht definiert sind) des aktuellen Elements ab. (Geerbt von OpenXmlElement)
Features	Ruft ein IFeatureCollection für das aktuelle Element ab. Diese Featuresammlung ist schreibgeschützt, erbt jedoch Features von ihrem übergeordneten Teil und Paket, falls verfügbar. (Geerbt von OpenXmlElement)
FirstChild	Ruft das erste untergeordnete Element des OpenXmlElement-Elements ab. Gibt null (Nothing in Visual Basic) zurück, wenn kein solches OpenXmlElement-Element vorhanden ist. (Geerbt von OpenXmlElement)
HasAttributes	Ruft einen Wert ab, der angibt, ob das aktuelle Element über Attribute verfügt. (Geerbt von OpenXmlElement)
HasChildren	Ruft einen Wert ab, der angibt, ob das aktuelle Element über untergeordnete Elemente verfügt. (Geerbt von OpenXmlLeafElement)
Hidden	Ausgeblendete Spalten Stellt das folgende Attribut im Schema dar: hidden
InnerText	Ruft die verketteten Werte des Knotens und aller untergeordneten Elemente ab oder legt diese fest. (Geerbt von OpenXmlElement)
InnerXml	Ruft das Markup ab, das nur untergeordnete Elemente des aktuellen Elements darstellt, oder legt dieses fest. (Geerbt von OpenXmlLeafElement)
LastChild	Ruft das letzte untergeordnete Element des OpenXmlElement-Elements ab. Gibt null (Nothing in Visual Basic) zurück, wenn kein solches OpenXmlElement-Element vorhanden ist. (Geerbt von OpenXmlElement)
LocalName	Ruft den lokalen Namen des aktuellen Elements ab. (Geerbt von OpenXmlElement)
Max	Maximale Spalte Stellt das folgende Attribut im Schema dar: max
MCAttributes	Ruft die Markupkompatibilitätsattribute ab oder legt sie fest. Gibt NULL zurück, wenn für das aktuelle Element keine Markupkompatibilitätsattribute definiert sind. (Geerbt von OpenXmlElement)
Min	Mindestspalte Stellt das folgende Attribut im Schema dar: min
NamespaceDeclarations	Ruft alle im aktuellen Element definierten Namespacedeklarationen ab. Gibt einen leeren Enumerator zurück, wenn keine Namespacedeklaration vorhanden ist. (Geerbt von OpenXmlElement)
NamespaceUri	Ruft den Namespace-URI des aktuellen Elements ab. (Geerbt von OpenXmlElement)
OpenXmlElementContext	Ruft den OpenXmlElementContext des aktuellen Elements ab. (Geerbt von OpenXmlElement)
OuterXml	Ruft das Markup ab, das das aktuelle Element und alle untergeordneten Elemente darstellt. (Geerbt von OpenXmlElement)
OutlineLevel	Gliederungsebene Stellt das folgende Attribut im Schema dar: outlineLevel
Parent	Ruft das übergeordnete Element des aktuellen Elements ab. (Geerbt von OpenXmlElement)
Phonetic	Phonetische Informationen anzeigen Stellt das folgende Attribut im Schema dar: phonetic
Prefix	Ruft das Namespacepräfix des aktuellen Elements ab. (Geerbt von OpenXmlElement)
Style	Format Stellt das folgende Attribut im Schema dar: style
Width	Spaltenbreite Stellt das folgende Attribut im Schema dar: width
XmlQualifiedName	Ruft den qualifizierten Namen des aktuellen Elements ab. (Geerbt von OpenXmlElement)
XName	Ruft den qualifizierten Namen des aktuellen Elements ab. (Geerbt von OpenXmlElement)

Methoden

AddAnnotation(Object)	Fügt der Liste der Anmerkungen des aktuellen OpenXmlElement-Elements ein -Objekt hinzu. (Geerbt von OpenXmlElement)
AddNamespaceDeclaration(String, String)	Fügt dem aktuellen Knoten eine Namespacedeklaration hinzu. (Geerbt von OpenXmlElement)
Ancestors()	Listet alle Vorgängerelemente des aktuellen Elements auf. (Geerbt von OpenXmlElement)
Ancestors<T>()	Listet nur die Vorgänger des aktuellen Elements auf, die den angegebenen Typ aufweisen. (Geerbt von OpenXmlElement)
Annotation(Type)	Ruft das erste Anmerkungsobjekt des angegebenen Typs aus dem aktuellen OpenXmlElement-Element ab. (Geerbt von OpenXmlElement)
Annotation<T>()	Ruft das erste Anmerkungsobjekt des angegebenen Typs aus dem aktuellen OpenXmlElement-Element ab. (Geerbt von OpenXmlElement)
Annotations(Type)	Ruft eine Auflistung von Anmerkungen mit dem angegebenen Typ für das aktuelle OpenXmlElement-Element ab. (Geerbt von OpenXmlElement)
Annotations<T>()	Ruft eine Auflistung von Anmerkungen mit dem angegebenen Typ für das aktuelle OpenXmlElement-Element ab. (Geerbt von OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Fügt jedes Element aus einer Liste von Elementen an das Ende der Liste der untergeordneten Elemente des aktuellen Elements an. (Geerbt von OpenXmlElement)
Append(OpenXmlElement[])	Fügt jedes Element aus einem Array von Elementen an das Ende der Liste der untergeordneten Elemente des aktuellen Elements an. (Geerbt von OpenXmlElement)
AppendChild<T>(T)	Fügt das angegebene Element am Ende der Liste der untergeordneten Knoten des aktuellen Elements an. (Geerbt von OpenXmlElement)
ClearAllAttributes()	Löscht alle Attribute, einschließlich bekannter und erweiterter Attribute. (Geerbt von OpenXmlElement)
Clone()	Erstellt ein Duplikat des aktuellen Knotens. (Geerbt von OpenXmlElement)
CloneNode(Boolean)	Erstellt ein Duplikat dieses Knotens.
Descendants()	Listet alle Nachfolger des aktuellen Elements auf. (Geerbt von OpenXmlElement)
Descendants<T>()	Listet alle Nachfolger des aktuellen Elements vom Typ T auf. (Geerbt von OpenXmlElement)
Elements()	Listet alle untergeordneten Elemente des aktuellen Elements auf. (Geerbt von OpenXmlElement)
Elements<T>()	Listet nur die untergeordneten Elemente des aktuellen Elements auf, die den angegebenen Typ aufweisen. (Geerbt von OpenXmlElement)
ElementsAfter()	Listet alle gleichgeordneten Elemente auf, die dem aktuellen Element folgen und dasselbe übergeordnete Element wie das aktuelle Element haben. (Geerbt von OpenXmlElement)
ElementsBefore()	Listet alle gleichgeordneten Elemente auf, die dem aktuellen Element vorausgehen und dasselbe übergeordnete Element wie das aktuelle Element haben. (Geerbt von OpenXmlElement)
GetAttribute(String, String)	Ruft ein Open XML-Attribut mit dem angegebenen Tagnamen und Namespace-URI ab. (Geerbt von OpenXmlElement)
GetAttributes()	Ruft eine Liste ab, die eine Kopie aller Attribute enthält. (Geerbt von OpenXmlElement)
GetEnumerator()	Gibt einen Enumerator zurück, der die untergeordnete Auflistung durchläuft. (Geerbt von OpenXmlElement)
GetFirstChild<T>()	Sucht das erste untergeordnete Element im Typ T. (Geerbt von OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Fügt das angegebene Element unmittelbar nach dem angegebenen Verweiselement ein. (Geerbt von OpenXmlElement)
InsertAfterSelf<T>(T)	Fügt das angegebene Element unmittelbar nach dem aktuellen Element ein. (Geerbt von OpenXmlElement)
InsertAt<T>(T, Int32)	Fügt das angegebene Element am angegebenen Index in die Liste der untergeordneten Elemente des aktuellen Elements ein. (Geerbt von OpenXmlElement)
InsertBefore<T>(T, OpenXmlElement)	Fügt das angegebene Element unmittelbar vor dem angegebenen Verweiselement ein. (Geerbt von OpenXmlElement)
InsertBeforeSelf<T>(T)	Fügt das angegebene Element unmittelbar vor dem aktuellen Element ein. (Geerbt von OpenXmlElement)
IsAfter(OpenXmlElement)	Bestimmt, ob das aktuelle Element nach einem angegebenen Element in Dokumentreihenfolge angezeigt wird. (Geerbt von OpenXmlElement)
IsBefore(OpenXmlElement)	Bestimmt, ob das aktuelle Element vor einem angegebenen Element in Dokumentreihenfolge angezeigt wird. (Geerbt von OpenXmlElement)
LookupNamespace(String)	Löst das Namespacepräfix im Kontext des aktuellen Knotens auf. (Geerbt von OpenXmlElement)
LookupPrefix(String)	Sucht das entsprechende Präfix für einen Namespace-URI im aktuellen Elementbereich. (Geerbt von OpenXmlElement)
NextSibling()	Ruft das OpenXmlElement-Element ab, das unmittelbar auf das aktuelle OpenXmlElement-Element folgt. Gibt null (Nothing in Visual Basic) zurück, wenn kein nächstes OpenXmlElement-Element vorhanden ist. (Geerbt von OpenXmlElement)
NextSibling<T>()	Ruft das OpenXmlElement-Element mit dem angegebenen Typ ab, der auf das aktuelle OpenXmlElement-Element folgt. Gibt null (Nothing in Visual Basic) zurück, wenn kein nächstes OpenXmlElement vorhanden ist. (Geerbt von OpenXmlElement)
PrependChild<T>(T)	Fügt das angegebene Element am Anfang der Liste der untergeordneten Elemente des aktuellen Elements ein. (Geerbt von OpenXmlElement)
PreviousSibling()	Ruft das OpenXmlElement-Element ab, das unmittelbar vor dem aktuellen OpenXmlElement-Element steht. Gibt null (Nothing in Visual Basic ) zurück, wenn kein vorangehendes OpenXmlElement-Element vorhanden ist. (Geerbt von OpenXmlElement)
PreviousSibling<T>()	Ruft das OpenXmlElement-Element mit dem angegebenen Typ ab, der dem aktuellen OpenXmlElement vorangestellt ist. Gibt null (Nothing in Visual Basic) zurück, wenn kein vorheriges OpenXmlElement-Element vorhanden ist. (Geerbt von OpenXmlElement)
Remove()	Entfernt das aktuelle Element aus dem übergeordneten Element. (Geerbt von OpenXmlElement)
RemoveAllChildren()	Entfernt alle untergeordneten Elemente des aktuellen Elements. (Geerbt von OpenXmlLeafElement)
RemoveAllChildren<T>()	Entfernen Sie alle untergeordneten Elemente des aktuellen Elements vom Typ T. (Geerbt von OpenXmlElement)
RemoveAnnotations(Type)	Entfernt die Anmerkungen des angegebenen Typs aus dem aktuellen OpenXmlElement-Element. (Geerbt von OpenXmlElement)
RemoveAnnotations<T>()	Entfernt die Anmerkungen mit dem angegebenen Typ aus dem aktuellen OpenXmlElement-Element. (Geerbt von OpenXmlElement)
RemoveAttribute(String, String)	Entfernt das Attribut aus dem aktuellen Element. (Geerbt von OpenXmlElement)
RemoveChild<T>(T)	Entfernt das angegebene untergeordnete Element aus der Liste der untergeordneten Elemente des aktuellen Elements. (Geerbt von OpenXmlElement)
RemoveNamespaceDeclaration(String)	Entfernt die Namespacedeklaration für das angegebene Präfix. Entfernt nichts, wenn kein Präfix vorhanden ist. (Geerbt von OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Ersetzt ein untergeordnetes Element durch ein anderes untergeordnetes Element in der Liste der untergeordneten Elemente des aktuellen Elements. (Geerbt von OpenXmlElement)
SetAttribute(OpenXmlAttribute)	Legt ein Attribut auf das angegebene Element fest. Wenn das Attribut ein bekanntes Attribut ist, wird der Wert des Attributs festgelegt. Wenn es sich bei dem Attribut um ein erweitertes Attribut handelt, wird das "openxmlAttribute" der Liste der erweiterten Attribute hinzugefügt. (Geerbt von OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Legt eine Reihe von Attributen für das -Element fest. Wenn ein Attribut ein bekanntes Attribut ist, wird der Wert des Attributs festgelegt. Wenn ein Attribut ein erweitertes Attribut ist, wird das "openxmlAttribute" der Liste der erweiterten Attribute hinzugefügt. (Geerbt von OpenXmlElement)
WriteTo(XmlWriter)	Speichert den aktuellen Knoten im angegebenen XmlWriter. (Geerbt von OpenXmlElement)

Explizite Schnittstellenimplementierungen

IEnumerable.GetEnumerator()	Spaltenbreite und -formatierung. Diese Klasse ist in Office 2007 und höher verfügbar. Wenn das Objekt als xml serialisiert wird, lautet der qualifizierte Name x:col. (Geerbt von OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Gibt einen Enumerator zurück, der die untergeordnete Auflistung durchläuft. (Geerbt von OpenXmlElement)