DataColumn.ColumnMapping プロパティ

定義

列の MappingType を取得または設定します。Gets or sets the MappingType of the column.

public:
 virtual property System::Data::MappingType ColumnMapping { System::Data::MappingType get(); void set(System::Data::MappingType value); };
public virtual System.Data.MappingType ColumnMapping { get; set; }
[System.Data.DataSysDescription("DataColumnMappingDescr")]
public virtual System.Data.MappingType ColumnMapping { get; set; }
member this.ColumnMapping : System.Data.MappingType with get, set
Public Overridable Property ColumnMapping As MappingType

プロパティ値

MappingType 値の 1 つ。One of the MappingType values.

属性

次の例では、new DataColumnColumnMapping type プロパティを設定します。The following example sets the ColumnMapping type property of new DataColumn.

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);
}
Private Sub AddColumn(table As DataTable )
    ' Create a new column and set its properties.
    Dim column As 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

注釈

DataSetWriteXml メソッドを使用して XML ドキュメントとして保存されている場合、ColumnMapping プロパティによって DataColumn がどのようにマップされるかが決まります。The ColumnMapping property determines how a DataColumn is mapped when a DataSet is saved as an XML document using the WriteXml method.

たとえば、DataColumn の名前が "customerID" で、その ColumnMapping プロパティが MappingType.Elementに設定されている場合、列の値によって次の XML が生成されます。For example, if a DataColumn is named "customerID," and its ColumnMapping property is set to MappingType.Element, the column value will produce the following XML:

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

ただし、同じ列が MappingType.Attributeにマップされている場合は、次の XML が生成されます。However, if the same column is mapped to MappingType.Attribute, the following XML is produced:

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

type 引数を含む DataColumn コンストラクターを使用して、DataSet を XML ドキュメントに変換するときの DataColumn のマップ方法を指定します。Use the DataColumn constructor that contains the type argument to specify how the DataColumn is mapped when its DataSet is transformed to an XML document.

ColumnMapping プロパティは、コンストラクターの引数 typeに対応します。The ColumnMapping property corresponds to the constructor argument type.

適用対象

こちらもご覧ください