Freigeben über


DataColumn.ColumnMapping-Eigenschaft

Ruft den MappingType der Spalte ab oder legt diesen fest.

Namespace: System.Data
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public Overridable Property ColumnMapping As MappingType
'Usage
Dim instance As DataColumn
Dim value As MappingType

value = instance.ColumnMapping

instance.ColumnMapping = value
public virtual MappingType ColumnMapping { get; set; }
public:
virtual property MappingType ColumnMapping {
    MappingType get ();
    void set (MappingType value);
}
/** @property */
public MappingType get_ColumnMapping ()

/** @property */
public void set_ColumnMapping (MappingType value)
public function get ColumnMapping () : MappingType

public function set ColumnMapping (value : MappingType)

Eigenschaftenwert

Einer der MappingType-Werte.

Hinweise

Die ColumnMapping-Eigenschaft bestimmt, wie eine DataColumn zugeordnet wird, wenn ein DataSet mit der WriteXml-Methode als XML-Dokument gespeichert wird.

Wenn z. B. der Name einer DataColumn "customerID" lautet und ihre ColumnMapping-Eigenschaft auf MappingType.Element festgelegt ist, erstellt der Spaltenwert folgenden XML-Code:

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

Wenn jedoch dieselbe Spalte MappingType.Attribute zugeordnet wird, ergibt sich folgender XML-Code:

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

Bestimmen Sie mit dem DataColumn-Konstruktor, der das type-Argument enthält, wie die DataColumn zugeordnet wird, wenn ihr DataSet in ein XML-Dokument umgewandelt wird.

Die ColumnMapping-Eigenschaft entspricht dem Konstruktorargument type.

Beispiel

Im folgenden Beispiel wird die ColumnMapping-Typeigenschaft der neuen DataColumn festgelegt.

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
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);
}

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

DataColumn-Klasse
DataColumn-Member
System.Data-Namespace