DataColumn Classe

Definição

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

public class DataColumn : System.ComponentModel.MarshalByValueComponent

type DataColumn = class
    inherit MarshalByValueComponent

Public Class DataColumn
Inherits MarshalByValueComponent

Herança

Object

MarshalByValueComponent

DataColumn

Exemplos

O exemplo seguinte 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

Observações

O DataColumn é o bloco fundamental para criar o esquema de um DataTable. Constróis o esquema adicionando um ou mais DataColumn objetos ao DataColumnCollection. Para mais informações, consulte Adicionar Colunas a uma Tabela de Dados.

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

Propriedades como AllowDBNull, Unique, e ReadOnly impõem restrições à introdução e atualização de dados, ajudando assim a garantir a integridade dos dados. Também pode usar as AutoIncrementpropriedades , AutoIncrementSeed, e AutoIncrementStep para controlar a geração automática de dados. Para mais informações sobre AutoIncrement colunas, consulte Criação de Colunas com AutoIncremento. Para obter mais informações, consulte Definindo chaves primárias.

Também pode garantir que os valores em a DataColumn são únicos criando a UniqueConstraint e adicionando-os ao ConstraintCollection de DataTable ao qual pertence.DataColumn Para obter mais informações, consulte DataTable Constraints.

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

Podes usar a Expression propriedade do DataColumn objeto para calcular os valores numa coluna, ou criar uma coluna agregada. Para mais informações, consulte Criação de Colunas de Expressão.

Segurança de Thread

Este tipo é seguro para operações de leitura multithread. Tem de sincronizar quaisquer operações de escrita.

Ver também

• Add(DataColumn)
• DataColumnCollection
• Constraints
• ConstraintCollection
• DataGrid
• DataRow
• DataTable
• DataSet
• NewRow()
• DataRowCollection
• UniqueConstraint
• Using DataSets in ADO.NET