DataColumn.ColumnMapping プロパティ

.NET Framework クラス ライブラリ リファレンス

DataColumn.ColumnMapping プロパティ

列の MappingType を取得または設定します。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Overridable Property
 ColumnMapping As MappingType

Visual Basic (使用法)

Dim instance As DataColumn
Dim value As MappingType

value = instance.ColumnMapping

instance.ColumnMapping = value

C#

public virtual MappingType ColumnMapping { get;
 set; }

C++

public:
virtual property MappingType ColumnMapping {
    MappingType get ();
    void set (MappingType value);
}

J#

/** @property */
public MappingType get_ColumnMapping ()

/** @property */
public void set_ColumnMapping (MappingType
 value)

JScript

public function get ColumnMapping
 () : MappingType

public function set ColumnMapping
 (value : MappingType)

プロパティ値
MappingType 値の 1 つ。

解説

ColumnMapping プロパティは、WriteXml メソッドを使用して DataSet を XML ドキュメントとして保存した場合に DataColumn を変換する方法を決定します。

たとえば、DataColumn が "customerID" という名前で、ColumnMapping プロパティが MappingType.Element に設定されている場合は、列値から次の XML が生成されます。

 <Customers>
  <customerID>ALFKI</customerID>
 ......
  </Customers>
  <Orders>
  <OrderID>12345</OrderID>
  <customerID>ALFKI</customerID>
 ......
  </Orders>

ただし、この同じ列を MappingType.Attribute に変換すると、次の XML が生成されます。

 <Customers customerID="ALFKI"........more attributes.....>
  <Order orderID="1234"....more attributes..../>
  <Order orderID="1234"....more attributes..../>
 ...... More orders for this customer
  </Customers>

DataColumn の DataSet を XML ドキュメントに変換した場合にその列を変換する方法を指定するには、引数 type を指定した DataColumn コンストラクタを使用します。

ColumnMapping プロパティは、コンストラクタの引数 type に対応しています。

使用例

新しい DataColumn の ColumnMapping 型プロパティを設定する例を次に示します。

Visual Basic

Private Sub AddColumn(table As
 DataTable )
    ' Create a new column and set its properties.
    Dim column As DataColumn = New
 DataColumn("ID", _
        Type.GetType("System.Int32"), "",
 MappingType.Attribute)
    column.DataType = Type.GetType("System.String")
    column.ColumnMapping = MappingType.Element

    ' Add the column the table's columns collection.
    table.Columns.Add(column)
End Sub

C#

private void AddColumn(DataTable table)
{
    // Create a new column and set its properties.
    DataColumn column = new DataColumn("column", 
        typeof(int), "", MappingType.Attribute);
    column.DataType = Type.GetType("System.String");
    column.ColumnMapping = MappingType.Element;

    // Add the column the table's columns collection.
    table.Columns.Add(column);
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
DataColumn クラス
DataColumn メンバ
System.Data 名前空間