Compartilhar via


DataColumn.ColumnMapping Propriedade

Definição

Obtém ou define o MappingType da coluna.

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
[<System.Data.DataSysDescription("DataColumnMappingDescr")>]
member this.ColumnMapping : System.Data.MappingType with get, set
Public Overridable Property ColumnMapping As MappingType

Valor da propriedade

Um dos valores de MappingType.

Atributos

Exemplos

O exemplo a seguir define a ColumnMapping propriedade type do novo 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

Comentários

A ColumnMapping propriedade determina como um DataColumn é mapeado quando um DataSet é salvo como um documento XML usando o WriteXml método .

Por exemplo, se um DataColumn for chamado de "customerID", e sua ColumnMapping propriedade for definida como MappingType.Element, o valor da coluna produzirá o seguinte XML:

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

No entanto, se a mesma coluna for mapeada para MappingType.Attribute, o seguinte XML será produzido:

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

Use o DataColumn construtor que contém o type argumento para especificar como o DataColumn é mapeado quando DataSet ele é transformado em um documento XML.

A ColumnMapping propriedade corresponde ao argumento typedo construtor .

Aplica-se a

Confira também