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 1st Edition]

col (列幅 & 書式設定)

ワークシートの 1 つ以上の列の列の幅と列の書式設定を定義します。

[例:この例では、列 5 (E) に幅とスタイルの情報が適用されていることを示しています。

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

例終わり]

親の要素
cols (§18.3.1.17)

属性	説明
bestFit (最適フィット列の幅)	指定した列が '最適' に設定されているかどうかを示すフラグ。 次の条件では、"最適フィット" が true に設定されています。 - 列の幅は、ユーザーが手動で設定したことはありません。 - 列の幅が既定の幅ではありません - [最適フィット] は、"最適フィット" 列に含まれるセルに数値を入力すると、列の幅が自動的にサイズ変更され、数値が表示されることを意味します。 [注: 最適な場合は、列の幅を小さくし、大きくする必要があります。 メモの終了] この属性で使用できる値は、W3C XML スキーマの boolean データ型で定義されています。
collapsed (Collapsed)	影響を受ける列のアウトラインが折りたたまれた状態であるかどうかを示すフラグ。 詳細については、行折りたたまれた行と outlinePr 要素の summaryBelow 属性と summaryRight 属性の説明を参照してください。 この属性で使用できる値は、W3C XML スキーマの boolean データ型で定義されています。
customWidth (カスタム幅)	影響を受ける列の列幅が既定値と異なるか、手動で設定されていることを示すフラグ。 この属性で使用できる値は、W3C XML スキーマの boolean データ型で定義されています。
hidden (非表示の列)	影響を受ける列がこのワークシートで非表示かどうかを示すフラグ。 この属性で使用できる値は、W3C XML スキーマの boolean データ型で定義されています。
max (最大列)	この "列情報" レコードの影響を受ける最後の列。 この属性に指定できる値は、W3C XML スキーマの unsignedInt データ型で定義されます。
min (最小列)	この '列情報' レコードの影響を受ける最初の列。 この属性に指定できる値は、W3C XML スキーマの unsignedInt データ型で定義されます。
outlineLevel (アウトライン レベル)	影響を受ける列のアウトライン レベル。 範囲は 0 から 7 です。 詳細については、outlinePr 要素の summaryBelow 属性と summaryRight 属性の説明を参照してください。 この属性に使用できる値は、W3C XML スキーマ unsignedByte データ型によって定義されます。
ふりがな (ふりがな情報を表示)	ワークシートの影響を受ける列のふりがな情報を既定で表示するかどうかを示すフラグ。 この属性で使用できる値は、W3C XML スキーマの boolean データ型で定義されています。
style (Style)	影響を受ける列の既定のスタイル。 列にまだ割り当てられていないセルに影響します。 つまり、このスタイルは新しい列に適用されます。 この属性に指定できる値は、W3C XML スキーマの unsignedInt データ型で定義されます。
width (列の幅)	列の幅は、通常のスタイルのフォントでレンダリングされる数値 0、1、2、...、9 の最大桁幅の文字数として測定されます。 余白のパディングには 4 ピクセル (両側に 2 つ)、グリッド線には 1 ピクセルのパディングがあります。 width = Truncate([{Number of Characters} * {Maximum Digit Width} + {5 pixel padding}]/{Maximum Digit Width}*256)/256 [例: 例として Calibri フォントを使用すると、11 ポイント フォント サイズの最大桁幅は 7 ピクセル (96 dpi) になります。 実際、各数字はこのフォントの幅が同じです。 したがって、セル幅が 8 文字幅の場合、この属性の値は Truncate([8*7+5]/7*256)/256 = 8.7109375 である必要があります。 例終わり] 実行時にファイルの width の値を列の幅の値 (ピクセル単位で表現) に変換するには、次の計算を使用します。 =Truncate(((256 * {width} + Truncate(128/{Maximum Digit Width}))/256)*{Maximum Digit Width}) [例: 上記と同じ例を使用すると、計算は Truncate((((256*8.7109375+Truncate(128/7)))/256)*7) = 61 ピクセルになります。 例終わり] ピクセルから文字幅に変換するには、次の計算を使用します。 =Truncate(({pixels}-5)/{Maximum Digit Width} * 100+0.5)/100 [例: 上の例を使用すると、計算は Truncate(((61-5)/7*100+0.5)/100 = 8 文字になります。 例終わり] [注: 幅の広い罫線を適用する場合、左右の罫線の一部が両側の 2 ピクセルのパディングと重なっている必要があります。 ワイド罫線は、列の幅の計算には影響しません。 メモの終了] [注: シートが値ではなく数式を表示するモードの場合、列のピクセル幅は 2 倍になります。 メモの終了] この属性に使用できる値は、W3C XML スキーマ のダブル データ型によって定義されます。

[注: この要素のコンテンツ モデル (CT_Col) の W3C XML スキーマ定義は§A.2 にあります。 メモの終了]

ISO/IEC29500: 2008。

コンストラクター

Column()

Column クラスの新しいインスタンスを初期化します。

プロパティ

BestFit	最適フィット列の幅 スキーマ内の次の属性を表します。 bestFit
ChildElements	現在の要素のすべての子ノードを取得します。 (継承元 OpenXmlElement)
Collapsed	Collapsed スキーマ内の次の属性を表します。折りたたまれています。
CustomWidth	カスタム幅 スキーマ内の次の属性を表します。 customWidth
ExtendedAttributes	現在の要素のすべての拡張属性 (スキーマで定義されていない属性) を取得します。 (継承元 OpenXmlElement)
Features	現在の要素の を IFeatureCollection 取得します。 この機能コレクションは読み取り専用ですが、使用可能な場合は親パーツとパッケージから機能を継承します。 (継承元 OpenXmlElement)
FirstChild	OpenXmlElement 要素の最初の子を取得します。 このような OpenXmlElement 要素がない場合は、null (Visual Basic では Nothing) を返します。 (継承元 OpenXmlElement)
HasAttributes	現在の要素に属性があるかどうかを示す値を取得します。 (継承元 OpenXmlElement)
HasChildren	現在の要素に子要素があるかどうかを示す値を取得します。 (継承元 OpenXmlLeafElement)
Hidden	非表示の列 スキーマ内の次の属性を表します。非表示
InnerText	ノードとそのすべての子の連結値を取得または設定します。 (継承元 OpenXmlElement)
InnerXml	現在の要素の子要素のみを表すマークアップを取得または設定します。 (継承元 OpenXmlLeafElement)
LastChild	OpenXmlElement 要素の最後の子を取得します。 このような OpenXmlElement 要素がない場合は、null (Visual Basic では Nothing) を返します。 (継承元 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)	指定したタグ名と名前空間 URI を持つ Open XML 属性を取得します。 (継承元 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 要素を取得します。 次の OpenXmlElement 要素がない場合は null (Visual Basic では Nothing) を返します。 (継承元 OpenXmlElement)
NextSibling<T>()	現在の OpenXmlElement 要素に続く指定した型を持つ OpenXmlElement 要素を取得します。 次の OpenXmlElement がない場合は、null (Visual Basic では Nothing) を返します。 (継承元 OpenXmlElement)
PrependChild<T>(T)	現在の要素の子要素のリストの先頭に、指定した要素を挿入します。 (継承元 OpenXmlElement)
PreviousSibling()	現在の OpenXmlElement 要素のすぐ前にある OpenXmlElement 要素を取得します。 前に OpenXmlElement 要素がない場合は、null (Visual Basic では Nothing) を返します。 (継承元 OpenXmlElement)
PreviousSibling<T>()	現在の OpenXmlElement の前に指定された型を持つ OpenXmlElement 要素を取得します。 前に OpenXmlElement 要素がない場合は null (Visual Basic では Nothing) を返します。 (継承元 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)