Column クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
列の幅と書式を設定します。 オブジェクトを xml としてシリアル化されるときに、修飾名は、x: col です。
public class Column : DocumentFormat.OpenXml.OpenXmlLeafElementtype Column = class
inherit OpenXmlLeafElementPublic Class Column
Inherits OpenXmlLeafElement- 継承
例
次の使用例は、読み取り専用アクセスのためのスプレッドシート ドキュメントを開きます。 ワークシート名とセル名を使用すると、そのカラム名を取得し、表示します。
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]
列 (列の幅と書式設定)
列の幅と列、ワークシートの 1 つまたは複数の列の書式設定を定義します。
[例: この例では、列 5 (E) には、幅とスタイルの情報を適用します。
<col min="5" max="5" width="9.140625" style="3"/>
例終わり]
| 親要素 |
|---|
| cols (§18.3.1.17) |
| 属性 | 説明 |
|---|---|
| bestFit (ベストに合わせて列の幅) | '最適' に指定された列が設定されている場合を示すフラグを設定します。 '最適' は、 true のような状況に設定されます。 -列の幅が設定されたことの手動で、ユーザーが -列の幅は既定の幅はありません。 -'最適' は、'最適' 列内のセルに数値が入力列の幅する必要があります数を表示するのには自動的にサイズ変更されることを意味します。 [メモ: 最適なサイズに合わせる場合は、列の幅する必要があります行われませんより小さいより大きめです。 メモの終了) この属性で使用できる値は、W3C XML スキーマの boolean データ型で定義されています。 |
| (折りたたみ) を折りたたむ | 場合に折りたたまれた状態では、影響を受ける列のアウトラインを示すフラグを設定します。 行が折りたたまれていると outlinePr 要素の summaryBelow 属性と summaryRight 属性の詳細についての説明を参照してください。 この属性で使用できる値は、W3C XML スキーマの boolean データ型で定義されています。 |
| customWidth (カスタムの幅) | 影響を受ける列の列幅が既定とは異なるまたは手動で設定されていることを示すフラグを設定します。 この属性で使用できる値は、W3C XML スキーマの boolean データ型で定義されています。 |
| 非表示 (非表示の列) | このワークシートで非表示に影響を受ける列場合、を示すフラグを設定します。 この属性で使用できる値は、W3C XML スキーマの boolean データ型で定義されています。 |
| max (最大の列) | 最後の列 '列の情報' レコードはこの影響を受けます。 この属性に指定できる値は、W3C XML スキーマの unsignedInt データ型で定義されます。 |
| min (最小の列) | 最初の列 '列の情報' レコードはこの影響を受けます。 この属性に指定できる値は、W3C XML スキーマの unsignedInt データ型で定義されます。 |
| outlineLevel (アウトライン レベル) | 影響を受ける列のレベルの概要を説明します。 範囲は、0 ~ 7 です。 OutlinePr 要素の summaryBelow 属性と summaryRight 属性の詳細については説明を参照してください。 UnsignedByteの W3C XML スキーマ データ型では、この属性の有効な値が定義されています。 |
| ふりがな (表音情報を表示) | 場合に既定では、ワークシートの影響を受ける列にふりがな情報を表示するかを示すフラグを設定します。 この属性で使用できる値は、W3C XML スキーマの boolean データ型で定義されています。 |
| スタイル (スタイル) | 影響を受ける列の既定のスタイルです。 列にまだ割り当てられているセルに影響を与えます。 つまり、このスタイルは、新しい列に適用されます。 この属性に指定できる値は、W3C XML スキーマの unsignedInt データ型で定義されます。 |
| 幅 (列幅) | 列の幅として測定される数値の最大の数字の幅の文字数 0、1、2、... と 9 が [標準] スタイルのフォントで表示します。 さらに 1 ピクセルのグリッド線の間隔は、(それぞれの側に 2 つ)、パディング、余白の 4 つのピクセルがあります。 幅 = Truncate([{Number of Characters} * {Maximum Digit Width} + {5 pixel padding}]/{Maximum Digit Width}*256)/256 [例: Calibri フォントを使用して、例として、11 ポイントのフォント サイズの最大の数字の幅は、(96 dpi) では 7 ピクセルです。 実際には、各桁は、このフォントの幅が同じです。 したがって、セルの幅は、8 文字分の幅であり、この属性の値は Truncate([8*7+5]/7*256)/256 である必要がある場合は、8.7109375 を = します。 例終わり] ファイルの幅の値を (ピクセル単位で表されます) の実行時に列幅の値に変換するには、この計算を使用します。 = 切り捨て (((256 * {幅} + 切り捨て (128/{最大桁幅}))/256)*{最大桁幅}) [例: 上記と同じ例を使用して、計算になります切り捨て (((256*8.7109375+Truncate(128/7))/256)*7) = 61 ピクセルです。 例終わり] 文字幅をピクセルから翻訳をするには、この計算を使用します。 = 切り捨て (({ピクセル}-5)/{最大桁幅} * 100 + 0.5)/100 [例: 上記の例を使用すると、計算になります切り捨て ((61-5)/7*100 + 0.5)/100 = 8 文字です。 例終わり] [注: 幅の広い罫線が適用されると、左/右の枠線の一部がパディングの各側面に 2 ピクセルに重なる必要があります。 幅の広い罫線は、列の幅の計算には影響しません。 メモの終了) [メモ: 値の代わりに数式を表示するモードで、シートが、列の幅をピクセル単位は 2 倍になります。 メモの終了) この属性の値は、二重の W3C XML スキーマ データ型によって定義されます。 |
[注: この要素のコンテンツ モデル (CT_Col) の W3C XML スキーマ定義は §A.2 であります。 メモの終了)
ISO/IEC29500: 2008。
コンストラクター
| Column() |
列のクラスの新しいインスタンスを初期化します。 |
プロパティ
| BestFit |
最高の次の属性がスキーマに合わせて列 Width.Represents: bestFit |
| ChildElements |
現在の要素のすべての子ノードを取得します。 (継承元 OpenXmlElement) |
| Collapsed |
Collapsed.Represents は、次のスキーマの属性: が折りたたまれています。 |
| CustomWidth |
次の属性がスキーマにカスタムの Width.Represents: customWidth |
| ExtendedAttributes |
現在の要素のすべての拡張属性 (スキーマで定義されていない属性) を取得します。 (継承元 OpenXmlElement) |
| FirstChild |
OpenXmlElement 要素の最初の子を取得します。 このような OpenXmlElement 要素がないVisual Basic null (Nothing in Visual Basic) を返します。 (継承元 OpenXmlElement) |
| HasAttributes |
現在の要素に属性が含されているかどうかを示すブール値を取得します。 (継承元 OpenXmlElement) |
| HasChildren |
現在の要素に子要素が含されているかどうかを示す値を取得します。 (継承元 OpenXmlLeafElement) |
| Hidden |
Columns.Represents は、次のスキーマの属性を非表示: 非表示 |
| InnerText |
ノードとそのすべての子の連結された値を取得します。 (継承元 OpenXmlElement) |
| InnerXml |
現在の要素の子要素のみを表すマークアップを取得または設定します。 (継承元 OpenXmlLeafElement) |
| LastChild |
OpenXmlElement 要素の最後の子を取得します。 このような OpenXmlElement 要素がないVisual Basic null (Nothing in Visual Basic) を返します。 (継承元 OpenXmlElement) |
| LocalName |
要素のローカル名を取得します。 |
| Max |
次のスキーマの属性の最大の Column.Represents: 最大 |
| MCAttributes |
マークアップの互換性属性を設定します。 現在の要素に対してマークアップ互換性属性が定義されていない場合は null を返します。 (継承元 OpenXmlElement) |
| Min |
次の属性がスキーマに最低限の Column.Represents: 最小 |
| NamespaceDeclarations |
現在の要素で定義されている名前空間宣言を取得します。 名前空間宣言がない場合は、空の列挙子を返します。 (継承元 OpenXmlElement) |
| NamespaceUri |
現在の要素の名前空間 URI を取得します。 (継承元 OpenXmlElement) |
| OpenXmlElementContext |
現在の要素の OpenXmlEementContext を取得します。 (継承元 OpenXmlElement) |
| OuterXml |
現在の要素とそのすべての子要素を表すマークアップを取得します。 (継承元 OpenXmlElement) |
| OutlineLevel |
Level.Represents は、次のスキーマの属性の概要: outlineLevel |
| Parent |
現在の要素の親要素を取得します。 (継承元 OpenXmlElement) |
| Phonetic |
スキーマ内のふりがな Information.Represents 次の属性を表示する: ふりがな |
| Prefix |
現在の要素の名前空間プレフィックスを取得します。 (継承元 OpenXmlElement) |
| Style |
Style.Represents は、次のスキーマの属性: スタイル |
| Width |
次のスキーマの属性列 Width.Represents: 幅 |
| XmlQualifiedName |
現在の要素の修飾名を取得します。 (継承元 OpenXmlElement) |
| XName |
現在の要素の修飾名を取得します。 (継承元 OpenXmlElement) |
メソッド
| AddAnnotation(Object) |
現在の OpenXmlElement 要素の注釈の一覧にオブジェクトを追加します。 (継承元 OpenXmlElement) |
| AddNamespaceDeclaration(String, String) |
現在のノードに namepace 宣言を追加します。 (継承元 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 要素がないVisual Basic null (Nothing in Visual Basic) を返します。 (継承元 OpenXmlElement) |
| NextSibling<T>() |
現在の OpenXmlElement 要素に続く、指定した型を持つ OpenXmlElement 要素を取得します。 次の OpenXmlElement がないVisual Basic null (Nothing in Visual Basic) を返します。 (継承元 OpenXmlElement) |
| PrependChild<T>(T) |
現在の要素の子要素のリストの先頭に、指定した要素を挿入します。 (継承元 OpenXmlElement) |
| PreviousSibling() |
現在の OpenXmlElement 要素の直前にある OpenXmlElement 要素を取得します。 前の OpenXmlElement 要素がないVisual Basic null ( Nothing in Visual Basic ) を返します。 (継承元 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() | (継承元 OpenXmlElement) |