Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

DataColumn.ColumnMapping-Eigenschaft

Aktualisiert: November 2007

Ruft den MappingType der Spalte ab oder legt diesen fest.

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

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

value = instance.ColumnMapping

instance.ColumnMapping = 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

Typ: System.Data.MappingType
Einer der MappingType-Werte.

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.

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


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

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 3.5, 2.0, 1.0

XNA Framework

Unterstützt in: 1.0
Anzeigen: