DataColumn DataColumn DataColumn DataColumn Class

Definição

Representa o esquema de uma coluna em um DataTable.Represents the schema of a column in a DataTable.

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

Exemplos

O exemplo a seguir cria DataTable um com DataColumn vários objetos.The following example creates a DataTable with several DataColumn objects.

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 DataTable = new DataTable("Product") 

    ' Create a DataColumn and set various properties. 
    Dim column As DataColumn = 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 DataTableum.The DataColumn is the fundamental building block for creating the schema of a DataTable. Você cria o esquema adicionando um ou mais DataColumn objetos DataColumnCollectionao.You build the schema by adding one or more DataColumn objects to the DataColumnCollection. Para obter mais informações, consulte adicionando colunas a uma DataTable.For more information, see Adding Columns to a DataTable.

Cada DataColumn tem uma DataType propriedade que determina DataColumn o tipo de dados que contém.Each DataColumn has a DataType property that determines the kind of data the DataColumn contains. Por exemplo, você pode restringir o tipo de dados a inteiros ou a cadeias de caracteres ou decimais.For example, you can restrict the data type to integers, or strings, or decimals. Como os DataTable dados contidos pelo são normalmente mesclados de volta à fonte de dados original, você deve corresponder os tipos de dados a eles na fonte de dados.Because data that is contained by the DataTable is typically merged back into its original data source, you must match the data types to those in the data source. Para obter mais informações, consulte mapeamentos de tipo de dados em ADO.net.For more information, see Data Type Mappings in ADO.NET.

Propriedades como AllowDBNull, Uniquee ReadOnly colocam restrições na entrada e na atualização de dados, ajudando a garantir a integridade dos dados.Properties such as AllowDBNull, Unique, and ReadOnly put restrictions on the entry and updating of data, thereby helping to guarantee data integrity. Você também pode usar as AutoIncrementpropriedades AutoIncrementSeed, e AutoIncrementStep para controlar a geração de dados automática.You can also use the AutoIncrement, AutoIncrementSeed, and AutoIncrementStep properties to control automatic data generation. Para obter mais informações AutoIncrement sobre colunas, consulte criando colunas de incremento automático.For more information about AutoIncrement columns, see Creating AutoIncrement Columns. Para obter mais informações, consulte definindo chaves primárias.For more information, see Defining Primary Keys.

Você também pode garantir que os valores em um DataColumn sejam exclusivos criando um UniqueConstraint ConstraintCollection e adicionando DataTable -os ao do ao qual o DataColumn pertence.You can also make sure that values in a DataColumn are unique by creating a UniqueConstraint and adding it to the ConstraintCollection of the DataTable to which the DataColumn belongs. Para obter mais informações, consulte as restrições de DataTable.For more information, see DataTable Constraints.

Para criar uma relação entre DataColumn objetos, crie um DataRelation objeto e adicione-o DataRelationCollection ao de um DataSet.To create a relation between DataColumn objects, create a DataRelation object and add it to the DataRelationCollection of a DataSet.

Você pode usar a Expression propriedade DataColumn do objeto para calcular os valores em uma coluna ou criar uma coluna de agregação.You can use the Expression property of the DataColumn object to calculate the values in a column, or create an aggregate column. Para obter mais informações, consulte criando colunas de expressão.For more information, see Creating Expression Columns.

Construtores

DataColumn() DataColumn() DataColumn() DataColumn()

Inicializa uma nova instância de uma classe DataColumn como uma cadeia de caracteres de tipo.Initializes a new instance of a DataColumn class as type string.

DataColumn(String) DataColumn(String) DataColumn(String) DataColumn(String)

Inicializa uma nova instância da classe DataColumn, como cadeia de caracteres de tipo, usando o nome de coluna especificado.Initializes a new instance of the DataColumn class, as type string, using the specified column name.

DataColumn(String, Type) DataColumn(String, Type) DataColumn(String, Type) DataColumn(String, Type)

Inicializa uma nova instância da classe DataColumn usando a o nome da coluna e o tipo de dados especificados.Initializes a new instance of the DataColumn class using the specified column name and data type.

DataColumn(String, Type, String) DataColumn(String, Type, String) DataColumn(String, Type, String) DataColumn(String, Type, String)

Inicializa uma nova instância da classe DataColumn usando o nome do parâmetro, o tipo de dados e a expressão especificados.Initializes a new instance of the DataColumn class using the specified name, data type, and expression.

DataColumn(String, Type, String, MappingType) DataColumn(String, Type, String, MappingType) DataColumn(String, Type, String, MappingType) DataColumn(String, Type, String, MappingType)

Inicializa uma nova instância da classe DataColumn usando o nome especificado, o tipo de dados, a expressão e o valor que determina se a coluna é um atributo.Initializes a new instance of the DataColumn class using the specified name, data type, expression, and value that determines whether the column is an attribute.

Propriedades

AllowDBNull AllowDBNull AllowDBNull AllowDBNull

Obtém ou define um valor que indica se valores nulos são permitidos nesta coluna para linhas que pertencem à tabela.Gets or sets a value that indicates whether null values are allowed in this column for rows that belong to the table.

AutoIncrement AutoIncrement AutoIncrement AutoIncrement

Obtém ou define um valor que indica se a coluna incrementa automaticamente o valor da coluna para novas linhas adicionadas à tabela.Gets or sets a value that indicates whether the column automatically increments the value of the column for new rows added to the table.

AutoIncrementSeed AutoIncrementSeed AutoIncrementSeed AutoIncrementSeed

Obtém ou define o valor inicial de uma coluna que tem a propriedade AutoIncrement definida como true.Gets or sets the starting value for a column that has its AutoIncrement property set to true. O padrão é 0.The default is 0.

AutoIncrementStep AutoIncrementStep AutoIncrementStep AutoIncrementStep

Obtém ou define o incremento usado por uma coluna com sua propriedade AutoIncrement definida como true.Gets or sets the increment used by a column with its AutoIncrement property set to true.

Caption Caption Caption Caption

Obtém ou define a legenda da coluna.Gets or sets the caption for the column.

ColumnMapping ColumnMapping ColumnMapping ColumnMapping

Obtém ou define o MappingType da coluna.Gets or sets the MappingType of the column.

ColumnName ColumnName ColumnName ColumnName

Obtém ou define o nome da coluna no DataColumnCollection.Gets or sets the name of the column in the DataColumnCollection.

Container Container Container Container

Obtém o contêiner para o componente.Gets the container for the component.

(Inherited from MarshalByValueComponent)
DataType DataType DataType DataType

Obtém ou define o tipo dos dados armazenados na coluna.Gets or sets the type of data stored in the column.

DateTimeMode DateTimeMode DateTimeMode DateTimeMode

Obtém ou define o DateTimeMode da coluna.Gets or sets the DateTimeMode for the column.

DefaultValue DefaultValue DefaultValue DefaultValue

Obtém ou define o valor padrão para a coluna ao criar novas linhas.Gets or sets the default value for the column when you are creating new rows.

DesignMode DesignMode DesignMode DesignMode

Obtém um valor que indica se o componente está atualmente no modo de design.Gets a value indicating whether the component is currently in design mode.

(Inherited from MarshalByValueComponent)
Events Events Events Events

Obtém a lista de manipuladores de eventos que estão anexados a este componente.Gets the list of event handlers that are attached to this component.

(Inherited from MarshalByValueComponent)
Expression Expression Expression Expression

Obtém ou define a expressão usada para filtrar linhas, calcular os valores em uma coluna ou criar uma coluna de agregação.Gets or sets the expression used to filter rows, calculate the values in a column, or create an aggregate column.

ExtendedProperties ExtendedProperties ExtendedProperties ExtendedProperties

Obtém a coleção de informações de usuário personalizadas associadas a um DataColumn.Gets the collection of custom user information associated with a DataColumn.

MaxLength MaxLength MaxLength MaxLength

Obtém ou define o tamanho máximo de uma coluna de texto.Gets or sets the maximum length of a text column.

Namespace Namespace Namespace Namespace

Obtém ou define o namespace do DataColumn.Gets or sets the namespace of the DataColumn.

Ordinal Ordinal Ordinal Ordinal

Obtém a posição (de base zero) da coluna na coleção DataColumnCollection.Gets the (zero-based) position of the column in the DataColumnCollection collection.

Prefix Prefix Prefix Prefix

Obtém ou define um prefixo XML que cria o alias do namespace do DataTable.Gets or sets an XML prefix that aliases the namespace of the DataTable.

ReadOnly ReadOnly ReadOnly ReadOnly

Obtém ou define um valor que indica se a coluna permite alterações assim que uma linha tiver sido adicionada à tabela.Gets or sets a value that indicates whether the column allows for changes as soon as a row has been added to the table.

Site Site Site Site

Obtém ou define o site do componente.Gets or sets the site of the component.

(Inherited from MarshalByValueComponent)
Table Table Table Table

Obtém o DataTable ao qual a coluna pertence.Gets the DataTable to which the column belongs to.

Unique Unique Unique Unique

Obtém ou define um valor que indica se os valores em cada linha da coluna devem ser exclusivos.Gets or sets a value that indicates whether the values in each row of the column must be unique.

Métodos

CheckNotAllowNull() CheckNotAllowNull() CheckNotAllowNull() CheckNotAllowNull()

Esse membro oferece suporte à infraestrutura .NET Framework e não se destina à utilização diretamente no seu código.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

CheckUnique() CheckUnique() CheckUnique() CheckUnique()

Esse membro oferece suporte à infraestrutura .NET Framework e não se destina à utilização diretamente no seu código.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Dispose() Dispose() Dispose() Dispose()

Libera todos os recursos usados pelo MarshalByValueComponent.Releases all resources used by the MarshalByValueComponent.

(Inherited from MarshalByValueComponent)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libera os recursos não gerenciados usados pelo MarshalByValueComponent e opcionalmente libera os recursos gerenciados.Releases the unmanaged resources used by the MarshalByValueComponent and optionally releases the managed resources.

(Inherited from MarshalByValueComponent)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from Object)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Obtém o implementador do IServiceProvider.Gets the implementer of the IServiceProvider.

(Inherited from MarshalByValueComponent)
GetType() GetType() GetType() GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs)

Esse membro oferece suporte à infraestrutura .NET Framework e não se destina à utilização diretamente no seu código.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

RaisePropertyChanging(String) RaisePropertyChanging(String) RaisePropertyChanging(String) RaisePropertyChanging(String)

Esse membro oferece suporte à infraestrutura .NET Framework e não se destina à utilização diretamente no seu código.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

SetOrdinal(Int32) SetOrdinal(Int32) SetOrdinal(Int32) SetOrdinal(Int32)

Altera o ordinal ou a posição do DataColumn para o ordinal ou a posição especificada.Changes the ordinal or position of the DataColumn to the specified ordinal or position.

ToString() ToString() ToString() ToString()

Obtém o Expression da coluna, se houver.Gets the Expression of the column, if one exists.

Eventos

Disposed Disposed Disposed Disposed

Adiciona um manipulador de eventos para escutar o evento Disposed no componente.Adds an event handler to listen to the Disposed event on the component.

(Inherited from MarshalByValueComponent)

Aplica-se a

Acesso thread-safe

Este tipo é seguro para operações de leitura e multithread.This type is safe for multithreaded read operations. Você deve sincronizar todas as operações de gravação.You must synchronize any write operations.

Veja também