Cette documentation est archivée et n’est pas conservée.

DataColumn.ColumnMapping, propriété

Mise à jour : novembre 2007

Obtient ou définit le MappingType de la colonne.

Espace de noms :  System.Data
Assembly :  System.Data (dans System.Data.dll)

'Déclaration
Public Overridable Property ColumnMapping As MappingType
'Utilisation
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)

Valeur de propriété

Type : System.Data.MappingType
Une des valeurs de MappingType.

La propriété ColumnMapping détermine la manière dont DataColumn est mappé si DataSet est enregistré en tant que document XML à l'aide de la méthode WriteXml.

Par exemple, si DataColumn est appelé "IDclient" et si la valeur MappingType.Element est affectée à sa propriété ColumnMapping, la valeur de la colonne génère le code XML suivant :

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

Cependant, si la même colonne est mappée à MappingType.Attribute, le code XML suivant est généré :

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

Utilisez le constructeur DataColumn qui contient l'argument type pour spécifier la manière dont DataColumn est mappé lorsque son DataSet est transformé en document XML.

La propriété ColumnMapping correspond à l'argument type du constructeur.

L'exemple suivant définit la propriété de type ColumnMapping du nouveau DataColumn.

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 Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile pour Smartphone, Windows Mobile pour Pocket PC, Xbox 360

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Pris en charge dans : 3.5, 2.0, 1.0

XNA Framework

Pris en charge dans : 1.0
Afficher: