Column Класс

Определение

Пространство имен:

DocumentFormat.OpenXml.Spreadsheet

Сборка:

DocumentFormat.OpenXml.dll

Пакет:

DocumentFormat.OpenXml v3.0.1

Ширина и форматирование столбца.

Этот класс доступен в Office 2007 и более поздних версиях.

Когда объект сериализуется как xml, его полное имя — x:col.

public class Column : DocumentFormat.OpenXml.OpenXmlLeafElement

type Column = class
    inherit OpenXmlLeafElement

Public Class Column
Inherits OpenXmlLeafElement

Наследование

Object

OpenXmlElement

OpenXmlLeafElement

Column

Примеры

В следующем примере открывается документ электронной таблицы для доступа только для чтения. Используя имя листа и имя ячейки, он получает имя столбца и отображает его.

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  

Комментарии

[ISO/IEC 29500-1 1 издание]

col (форматирование ширины столбца &)

Определяет ширину и форматирование столбцов для одного или нескольких столбцов листа.

[Пример. В этом примере показано, что в столбце 5 (E) применены сведения о ширине и стиле.

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

конец примера

Родительские элементы
cols (§18.3.1.17)

Атрибуты	Описание
bestFit (оптимальная ширина столбца)	Флаг, указывающий, задано ли для указанных столбцов значение "best fit". Для параметра Best Fit (Оптимальное соответствие) задано значение true при следующих условиях: — ширина столбца никогда не устанавливалась пользователем вручную. — Ширина столбца не является шириной по умолчанию. - "Оптимальное соответствие" означает, что при вводе чисел в ячейку, содержащуюся в столбце "лучше всего подходит", ширина столбца должна автоматически изменяться для отображения числа. [Примечание. В лучшем случае ширина столбца не должна быть меньше, а только больше. конечная заметка] Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
свернуто (свернуто)	Флаг, указывающий, находится ли структурирование затронутых столбцов в свернутом состоянии. Подробные сведения см. в описании атрибутов summaryBelow и summaryRight элемента outlinePr. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
customWidth (настраиваемая ширина)	Флаг, указывающий, что ширина столбца для затронутых столбцов отличается от значения по умолчанию или задана вручную. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
hidden (скрытые столбцы)	Флаг, указывающий, скрыты ли затронутые столбцы на этом листе. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
max (максимальное значение столбца)	Последний столбец, затронутый этой записью "сведения о столбце". Возможные значения для этого атрибута определены в типе данных unsignedInt схемы W3C XML.
min (минимальный столбец)	Первый столбец, затронутый этой записью "сведения о столбце". Возможные значения для этого атрибута определены в типе данных unsignedInt схемы W3C XML.
outlineLevel (уровень структуры)	Уровень структуры затронутых столбцов. Диапазон от 0 до 7. Подробные сведения см. в описании атрибутов summaryBelow и summaryRight элемента outlinePr. Возможные значения для этого атрибута определяются типом данных W3C XML Schema unsignedByte .
фонетический (показать фонетическую информацию)	Флаг, указывающий, должны ли по умолчанию отображаться фонетические сведения для затронутых столбцов листа. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
style (Style)	Стиль по умолчанию для затронутых столбцов. Влияет на ячейки, еще не выделенные в столбцах. Другими словами, этот стиль применяется к новым столбцам. Возможные значения для этого атрибута определены в типе данных unsignedInt схемы W3C XML.
width (ширина столбца)	Ширина столбца, измеряемая как число символов максимальной ширины цифр числа 0, 1, 2, ..., 9, отрисованных в шрифте обычного стиля. Имеется 4 пикселя полей (по два с каждой стороны), а также 1 пиксель для линий сетки. width = Усечение([{Количество символов} * {Максимальная ширина цифр} + {5 пикселей заполнение}]/{Максимальная ширина цифр}*256)/256 [Пример. При использовании шрифта Calibri в качестве примера максимальная ширина цифры размером шрифта 11 точек составляет 7 пикселей (96 точек на дюйм). На самом деле каждая цифра имеет одинаковую ширину для этого шрифта. Таким образом, если ширина ячейки составляет 8 символов, значение этого атрибута должно быть усечено([8*7+5]/7*256)/256 = 8,7109375. конец примера Чтобы преобразовать значение ширины в файле в значение ширины столбца во время выполнения (выраженное в пикселях), используйте следующее вычисление: =Усечение((((256 * {width} + Усечение(128/{Максимальная ширина цифр}))/256)*{Максимальная ширина цифр}) [Пример. Используя тот же пример, что и выше, вычисление будет иметь значение Truncate(((256*8.7109375+Truncate(128/7))/256)*7) = 61 пикселей. конец примера Для преобразования с пикселей на ширину символов используйте следующее вычисление: =Усечение(({pixels}-5)/{Максимальная ширина цифр} * 100+0,5)/100 [Пример. Используя приведенный выше пример, вычисление будет иметь значение Truncate((61-5)/7*100+0,5)/100 = 8 символов. конец примера [Примечание. При применении широких границ часть левой или правой границы должна перекрываться с заполнением по 2 пикселя на каждой стороне. Широкие границы не влияют на вычисление ширины столбца. конечная заметка] [Примечание. Если лист находится в режиме просмотра формул, а не значений, ширина столбца в пикселях удваивается. конечная заметка] Возможные значения для этого атрибута определяются двойным типом данных схемы XML W3C.

[Примечание. Определение xml-схемы W3C для модели содержимого этого элемента (CT_Col) находится в §A.2. конечная заметка]

ISO/IEC29500: 2008.

Конструкторы

Column()

Инициализирует новый экземпляр класса Column.

Свойства

BestFit	Оптимальная ширина столбца Представляет следующий атрибут в схеме: bestFit
ChildElements	Возвращает все дочерние узлы текущего элемента. (Унаследовано от OpenXmlElement)
Collapsed	Collapsed Представляет следующий атрибут в схеме: свернутый
CustomWidth	Настраиваемая ширина Представляет следующий атрибут в схеме: customWidth
ExtendedAttributes	Возвращает все расширенные атрибуты (атрибуты, не определенные в схеме) текущего элемента. (Унаследовано от OpenXmlElement)
Features	IFeatureCollection Возвращает для текущего элемента. Эта коллекция компонентов будет доступна только для чтения, но будет наследовать компоненты от родительской части и пакета, если они доступны. (Унаследовано от OpenXmlElement)
FirstChild	Возвращает первый дочерний элемент элемента OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если такого элемента OpenXmlElement нет. (Унаследовано от OpenXmlElement)
HasAttributes	Возвращает значение, указывающее, имеет ли текущий элемент какие-либо атрибуты. (Унаследовано от OpenXmlElement)
HasChildren	Возвращает значение, указывающее, содержит ли текущий элемент какие-либо дочерние элементы. (Унаследовано от OpenXmlLeafElement)
Hidden	Скрытые столбцы Представляет следующий атрибут в схеме: hidden
InnerText	Возвращает или задает объединенные значения узла и всех его дочерних элементов. (Унаследовано от OpenXmlElement)
InnerXml	Возвращает или задает разметку, представляющую только дочерние элементы текущего элемента. (Унаследовано от OpenXmlLeafElement)
LastChild	Возвращает последний дочерний элемент элемента OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если такого элемента OpenXmlElement нет. (Унаследовано от OpenXmlElement)
LocalName	Возвращает локальное имя текущего элемента. (Унаследовано от OpenXmlElement)
Max	Максимальное число столбцов Представляет следующий атрибут в схеме: max
MCAttributes	Возвращает или задает атрибуты совместимости разметки. Возвращает значение NULL, если для текущего элемента не определены атрибуты совместимости разметки. (Унаследовано от OpenXmlElement)
Min	Минимальный столбец Представляет следующий атрибут в схеме: min
NamespaceDeclarations	Возвращает все объявления пространства имен, определенные в текущем элементе. Возвращает пустой перечислитель, если нет объявления пространства имен. (Унаследовано от OpenXmlElement)
NamespaceUri	Возвращает универсальный код ресурса (URI) пространства имен текущего элемента. (Унаследовано от OpenXmlElement)
OpenXmlElementContext	Возвращает openXmlElementContext текущего элемента. (Унаследовано от OpenXmlElement)
OuterXml	Возвращает разметку, представляющую текущий элемент и все его дочерние элементы. (Унаследовано от OpenXmlElement)
OutlineLevel	Уровень структуры Представляет следующий атрибут в схеме: outlineLevel
Parent	Возвращает родительский элемент текущего элемента. (Унаследовано от OpenXmlElement)
Phonetic	Показать фонетическую информацию Представляет следующий атрибут в схеме: фонетический
Prefix	Возвращает префикс пространства имен текущего элемента. (Унаследовано от OpenXmlElement)
Style	Стиль Представляет следующий атрибут в схеме: style
Width	Ширина столбца Представляет следующий атрибут в схеме: width
XmlQualifiedName	Возвращает полное имя текущего элемента. (Унаследовано от OpenXmlElement)
XName	Возвращает полное имя текущего элемента. (Унаследовано от OpenXmlElement)

Методы

AddAnnotation(Object)	Добавляет объект в список заметок текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
AddNamespaceDeclaration(String, String)	Добавляет объявление пространства имен в текущий узел. (Унаследовано от OpenXmlElement)
Ancestors()	Перечисляет все предки текущего элемента. (Унаследовано от OpenXmlElement)
Ancestors<T>()	Перечисляет только предки текущего элемента, имеющие указанный тип. (Унаследовано от OpenXmlElement)
Annotation(Type)	Получение первого объекта заметки указанного типа из текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
Annotation<T>()	Получение первого объекта заметки указанного типа из текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
Annotations(Type)	Возвращает коллекцию заметок с указанным типом для текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
Annotations<T>()	Возвращает коллекцию заметок с указанным типом для текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Добавляет каждый элемент из списка элементов в конец списка дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement)
Append(OpenXmlElement[])	Добавляет каждый элемент из массива элементов в конец списка дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement)
AppendChild<T>(T)	Добавляет указанный элемент в конец списка дочерних узлов текущего элемента. (Унаследовано от OpenXmlElement)
ClearAllAttributes()	Очищает все атрибуты, включая как известные, так и расширенные атрибуты. (Унаследовано от OpenXmlElement)
Clone()	Создает дубликат текущего узла. (Унаследовано от OpenXmlElement)
CloneNode(Boolean)	Создает дубликат этого узла.
Descendants()	Перечисляет все потомки текущего элемента. (Унаследовано от OpenXmlElement)
Descendants<T>()	Перечисление всех потомков текущего элемента типа T. (Унаследовано от OpenXmlElement)
Elements()	Перечисляет все дочерние элементы текущего элемента. (Унаследовано от OpenXmlElement)
Elements<T>()	Перечисляет только дочерние элементы текущего элемента, имеющие указанный тип. (Унаследовано от OpenXmlElement)
ElementsAfter()	Перечисляет все одноуровневые элементы, которые следуют за текущим элементом и имеют тот же родительский элемент, что и текущий элемент. (Унаследовано от OpenXmlElement)
ElementsBefore()	Перечисляет все одноуровневые элементы, которые предшествуют текущему элементу и имеют тот же родительский элемент, что и текущий элемент. (Унаследовано от OpenXmlElement)
GetAttribute(String, String)	Возвращает атрибут Open XML с указанным именем тега и URI пространства имен. (Унаследовано от OpenXmlElement)
GetAttributes()	Возвращает список, содержащий копию всех атрибутов. (Унаследовано от OpenXmlElement)
GetEnumerator()	Возвращает перечислитель, который выполняет итерацию по дочерней коллекции. (Унаследовано от OpenXmlElement)
GetFirstChild<T>()	Находит первый дочерний элемент в типе T. (Унаследовано от OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Вставляет указанный элемент сразу после указанного ссылочного элемента. (Унаследовано от OpenXmlElement)
InsertAfterSelf<T>(T)	Вставляет указанный элемент сразу после текущего элемента. (Унаследовано от OpenXmlElement)
InsertAt<T>(T, Int32)	Вставляет указанный элемент по указанному индексу в список дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement)
InsertBefore<T>(T, OpenXmlElement)	Вставляет указанный элемент непосредственно перед указанным ссылочным элементом. (Унаследовано от OpenXmlElement)
InsertBeforeSelf<T>(T)	Вставляет указанный элемент непосредственно перед текущим элементом. (Унаследовано от OpenXmlElement)
IsAfter(OpenXmlElement)	Определяет, отображается ли текущий элемент после указанного элемента в порядке документа. (Унаследовано от OpenXmlElement)
IsBefore(OpenXmlElement)	Определяет, отображается ли текущий элемент перед указанным элементом в порядке документа. (Унаследовано от OpenXmlElement)
LookupNamespace(String)	Разрешает префикс пространства имен в контексте текущего узла. (Унаследовано от OpenXmlElement)
LookupPrefix(String)	Находит соответствующий префикс для URI пространства имен в текущем элементе область. (Унаследовано от OpenXmlElement)
NextSibling()	Возвращает элемент OpenXmlElement, который сразу же следует за текущим элементом OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет следующего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
NextSibling<T>()	Возвращает элемент OpenXmlElement с указанным типом, который следует за текущим элементом OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет следующего OpenXmlElement. (Унаследовано от OpenXmlElement)
PrependChild<T>(T)	Вставляет указанный элемент в начало списка дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement)
PreviousSibling()	Возвращает элемент OpenXmlElement, который непосредственно предшествует текущему элементу OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет предыдущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
PreviousSibling<T>()	Возвращает элемент OpenXmlElement с указанным типом, который предшествует текущему объекту OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет предыдущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
Remove()	Удаляет текущий элемент из родительского элемента. (Унаследовано от OpenXmlElement)
RemoveAllChildren()	Удаляет все дочерние элементы текущего элемента. (Унаследовано от OpenXmlLeafElement)
RemoveAllChildren<T>()	Удалите все дочерние элементы текущего элемента типа T. (Унаследовано от OpenXmlElement)
RemoveAnnotations(Type)	Удаляет заметки указанного типа из текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
RemoveAnnotations<T>()	Удаляет заметки с указанным типом из текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
RemoveAttribute(String, String)	Удаляет атрибут из текущего элемента. (Унаследовано от OpenXmlElement)
RemoveChild<T>(T)	Удаляет указанный дочерний элемент из списка дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement)
RemoveNamespaceDeclaration(String)	Удаляет объявление пространства имен для указанного префикса. Ничего не удаляет, если нет префикса. (Унаследовано от OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Заменяет дочерний элемент другим дочерним элементом в списке дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement)
SetAttribute(OpenXmlAttribute)	Задает атрибут заданного элемента. Если атрибут является известным атрибутом, задается значение атрибута. Если атрибут является расширенным атрибутом, в список расширенных атрибутов добавляется openxmlAttribute. (Унаследовано от OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Задает ряд атрибутов элемента . Если атрибут является известным атрибутом, задается значение атрибута. Если атрибут является расширенным атрибутом, в список расширенных атрибутов добавляется openxmlAttribute. (Унаследовано от OpenXmlElement)
WriteTo(XmlWriter)	Сохраняет текущий узел в указанном xmlWriter. (Унаследовано от OpenXmlElement)

Явные реализации интерфейса

IEnumerable.GetEnumerator()	Ширина и форматирование столбца. Этот класс доступен в Office 2007 и более поздних версиях. Когда объект сериализуется как xml, его полное имя — x:col. (Унаследовано от OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Возвращает перечислитель, который выполняет итерацию по дочерней коллекции. (Унаследовано от OpenXmlElement)