DataColumn Classe

Definição

public ref class DataColumn : System::ComponentModel::MarshalByValueComponent

[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
public class DataColumn : System.ComponentModel.MarshalByValueComponent

public class DataColumn : System.ComponentModel.MarshalByValueComponent

[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
type DataColumn = class
    inherit MarshalByValueComponent

type DataColumn = class
    inherit MarshalByValueComponent

Public Class DataColumn
Inherits MarshalByValueComponent

Herança

Object

MarshalByValueComponent

DataColumn

Atributos

DynamicallyAccessedMembersAttribute

Exemplos

O exemplo a seguir cria um DataTable com vários DataColumn objetos.

private void MakeTable()
{
    // Create a DataTable.
    DataTable table = new DataTable("Product");

    // Create a DataColumn and set various properties.
    DataColumn column = new DataColumn();
    column.DataType = System.Type.GetType("System.Decimal");
    column.AllowDBNull = false;
    column.Caption = "Price";
    column.ColumnName = "Price";
    column.DefaultValue = 25;

    // Add the column to the table.
    table.Columns.Add(column);

    // Add 10 rows and set values.
    DataRow row;
    for(int i = 0; i < 10; i++)
    {
        row = table.NewRow();
        row["Price"] = i + 1;

        // Be sure to add the new row to the
        // DataRowCollection.
        table.Rows.Add(row);
    }
}

Private Sub MakeTable()
    ' Create a DataTable. 
    Dim table As New DataTable("Product")

    ' Create a DataColumn and set various properties. 
    Dim column As New DataColumn()
    column.DataType = System.Type.GetType("System.Decimal") 
    column.AllowDBNull = False 
    column.Caption = "Price"  
    column.ColumnName = "Price" 
    column.DefaultValue = 25 

    ' Add the column to the table. 
    table.Columns.Add(column) 

    ' Add 10 rows and set values. 
    Dim row As DataRow 
    Dim i As Integer  
    For i = 0 to 9 
        row = table.NewRow() 
        row("Price") = i + 1 

        ' Be sure to add the new row to 
        ' the DataRowCollection. 
        table.Rows.Add(row) 
    Next i 
End Sub

Comentários

O DataColumn é o bloco de construção fundamental para criar o esquema de um DataTable. Você cria o esquema adicionando um ou mais DataColumn objetos ao DataColumnCollection. Para obter mais informações, consulte Como adicionar colunas a uma DataTable.

Cada DataColumn um tem uma DataType propriedade que determina o tipo de dados que contém DataColumn . Por exemplo, você pode restringir o tipo de dados a inteiros, cadeias de caracteres ou decimais. Como os DataTable dados contidos na fonte de dados normalmente são mesclados de volta à fonte de dados original, você deve corresponder os tipos de dados aos da fonte de dados. Para obter mais informações, consulte Mapeamentos de tipo de dados em ADO.NET.

Propriedades como AllowDBNull, Uniquee ReadOnly colocar restrições na entrada e atualização de dados, ajudando assim a garantir a integridade dos dados. Você também pode usar as propriedades e AutoIncrementStep as AutoIncrementAutoIncrementSeedpropriedades para controlar a geração automática de dados. Para obter mais informações sobre AutoIncrement colunas, consulte Criando Colunas de AutoIncremento. Para obter mais informações, consulte Definindo chaves primárias.

Você também pode certificar-se de que os valores em um DataColumn são exclusivos criando um UniqueConstraint e adicionando-o ConstraintCollection ao do DataTable qual o DataColumn pertence. Para obter mais informações, consulte Restrições de DataTable.

Para criar uma relação entre DataColumn objetos, crie um DataRelation objeto e adicione-o ao DataRelationCollection de um DataSet.

Você pode usar a Expression propriedade do DataColumn objeto para calcular os valores em uma coluna ou criar uma coluna de agregação. Para obter mais informações, consulte Criando colunas de expressão.

Acesso thread-safe

Esse tipo é seguro para operações de leitura multithreaded. Você deve sincronizar todas as operações de gravação.

Confira também

• Add(DataColumn)
• DataColumnCollection
• Constraints
• ConstraintCollection
• DataGrid
• DataRow
• DataTable
• DataSet
• NewRow()
• DataRowCollection
• UniqueConstraint
• Usando Conjuntos de Dados no ADO.NET