Эта документация перемещена в архив и не поддерживается.

DataColumn.ColumnMapping - свойство

Обновлен: Ноябрь 2007

Возвращает или задает MappingType столбца.

Пространство имен:  System.Data
Сборка:  System.Data (в System.Data.dll)

'Декларация
Public Overridable Property ColumnMapping As MappingType
'Применение
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)

Значение свойства

Тип: System.Data.MappingType
Одно из значений MappingType.

Свойство ColumnMapping определяет, как сопоставляется DataColumn, когда DataSet сохраняется в виде документа XML с помощью метода WriteXml.

Например, если DataColumn имеет имя customerID и значение его свойства ColumnMapping равно MappingType.Element, значение столбца создается следующий XML-код:

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

Однако, если тот же столбец сопоставлен с MappingType.Attribute, создается следующий XML-код:

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

Используйте конструктор DataColumn, содержащий аргумент type, для указания того, как сопоставляется DataColumn, когда DataSet преобразуется в документ XML.

Свойство ColumnMapping соответствует аргументу конструктора type.

В следующем примере устанавливается свойство типа ColumnMapping нового 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 с пакетом обновления 2 (SP2), Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 с пакетом обновления 4 (SP4), Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile для карманных ПК, Xbox 360

Среды .NET Framework и .NET Compact Framework поддерживают не все версии каждой платформы. Поддерживаемые версии перечислены в разделе Требования к системе для .NET Framework.

.NET Framework

Поддерживается в версиях: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Поддерживается в версиях: 3.5, 2.0, 1.0

XNA Framework

Поддерживается в версии: 1.0
Показ: