DataColumn.ColumnMapping プロパティ

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

Public Overridable Property ColumnMapping As MappingType
[C#]
public virtual MappingType ColumnMapping {get; set;}
[C++]
public: __property virtual MappingType get_ColumnMapping();public: __property virtual void set_ColumnMapping(MappingType);
[JScript]
public function get ColumnMapping() : MappingType;public function set ColumnMapping(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 に対応しています。

使用例

[Visual Basic, C#, C++] 新しい DataColumn の ColumnMapping 型プロパティを設定する例を次に示します。

 
Private Sub AddColumn(myTable As DataTable )
    ' Create a new column and set its properties.
    Dim myColumn As DataColumn = New DataColumn("myColumn", Type.GetType("System.Int32"), "", MappingType.Attribute)
    myColumn.DataType = Type.GetType("System.String")
    myColumn.ColumnMapping = MappingType.Element
    ' Add the column the table's columns collection.
    myTable.Columns.Add(myColumn)
 End Sub

[C#] 
private void AddColumn(DataTable myTable){
    // Create a new column and set its properties.
    DataColumn myColumn = new DataColumn("myColumn", typeof(int), "", MappingType.Attribute);
    myColumn.DataType = Type.GetType("System.String");
    myColumn.ColumnMapping = MappingType.Element;
    // Add the column the table's columns collection.
    myTable.Columns.Add(myColumn);
 }

[C++] 
private:
void AddColumn(DataTable* myTable){
    // Create a new column and set its properties.
    DataColumn* myColumn = new DataColumn(S"myColumn", __typeof(int), S"", MappingType::Attribute);
    myColumn->DataType = Type::GetType(S"System.String");
    myColumn->ColumnMapping = MappingType::Element;
    // Add the column the table's columns collection.
    myTable->Columns->Add(myColumn);
 }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

DataColumn クラス | DataColumn メンバ | System.Data 名前空間