DataColumn.ColumnMapping Eigenschaft

Definition

Ruft den MappingType der Spalte ab oder legt ihn fest.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

Eigenschaftswert

MappingType

Einer der MappingType-Werte.One of the MappingType values.

Attribute

Beispiele

Im folgenden Beispiel wird die Eigenschaft ColumnMapping Type von New DataColumnfestgelegt.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

Hinweise

Die ColumnMapping-Eigenschaft bestimmt, wie eine DataColumn zugeordnet wird, wenn eine DataSet mithilfe der WriteXml-Methode als XML-Dokument gespeichert wird.The ColumnMapping property determines how a DataColumn is mapped when a DataSet is saved as an XML document using the WriteXml method.

Wenn beispielsweise ein DataColumn mit dem Namen "CustomerID" und seine ColumnMapping-Eigenschaft auf MappingType.Elementfestgelegt ist, erzeugt der Spaltenwert den folgenden XML-Code: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>  

Wenn jedoch die gleiche Spalte MappingType.Attributezugeordnet ist, wird der folgende XML-Code erstellt: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>  

Verwenden Sie den DataColumn-Konstruktor, der das type-Argument enthält, um anzugeben, wie die DataColumn zugeordnet wird, wenn deren DataSet in ein XML-Dokument transformiert wird.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.

Die ColumnMapping-Eigenschaft entspricht dem typedes Konstruktorarguments.The ColumnMapping property corresponds to the constructor argument type.

Gilt für:

Siehe auch