DataColumn Construtores

Definição

Namespace:

System.Data

Assemblies:

netstandard.dll, System.Data.Common.dll

Inicializa uma nova instância da classe DataColumn.

Sobrecargas

Nome	Description
DataColumn()	Inicializa uma nova instância da classe como cadeia DataColumn de caracteres de tipo.
DataColumn(String)	Inicializa uma nova instância da classe, como cadeia DataColumn de caracteres de tipo, usando o nome da coluna especificado.
DataColumn(String, Type)	Inicializa uma nova instância da DataColumn classe usando o nome da coluna e o tipo de dados especificados.
DataColumn(String, Type, String)	Inicializa uma nova instância da DataColumn classe usando o nome, o tipo de dados e a expressão especificados.
DataColumn(String, Type, String, MappingType)	Inicializa uma nova instância da DataColumn classe usando o nome, o tipo de dados, a expressão e o valor especificados que determina se a coluna é um atributo.

DataColumn()

Origem:

DataColumn.cs

Inicializa uma nova instância da classe como cadeia DataColumn de caracteres de tipo.

public:
 DataColumn();

public DataColumn();

Public Sub New ()

Exemplos

O exemplo a seguir cria um novo DataColumn, define várias propriedades e o adiciona a um DataColumnCollection para o DataTable objeto.

private void AddDataColumn(DataTable table)
{
    DataColumn column = new DataColumn();

    // Set various properties.
    column.ColumnName = "id";
    column.DataType = System.Type.GetType("System.Int32");
    column.AutoIncrement = true;
    column.AutoIncrementSeed = 1;
    column.AutoIncrementStep = 1;
    column.ReadOnly = true;

    // Add to Columns collection.
    table.Columns.Add(column);
}

Private Sub AddDataColumn(ByVal table As DataTable)
    Dim column As New DataColumn()

    ' Set various properties.
    With column
       .ColumnName = "id"
       .DataType = System.Type.GetType("System.Int32")
       .AutoIncrement = True
       .AutoIncrementSeed = 1
       .AutoIncrementStep = 1
       .ReadOnly = True
     End With

    ' Add to Columns collection.
    table.Columns.Add(column)
End Sub

Comentários

Quando criado, um DataColumn objeto não tem nenhum padrão ColumnName ou Caption. Quando você adicioná-lo a um DataColumnCollectionnome padrão ("Column1", "Column2" e assim por diante) será gerado se um nome não tiver sido atribuído ao ColumnName.

Confira também

• ColumnName
• Caption
• DefaultValue
• DataTable
• DataType
• Usando Conjuntos de Dados no ADO.NET

DataColumn(String)

Origem:

DataColumn.cs

Inicializa uma nova instância da classe, como cadeia DataColumn de caracteres de tipo, usando o nome da coluna especificado.

public:
 DataColumn(System::String ^ columnName);

public DataColumn(string? columnName);

new System.Data.DataColumn : string -> System.Data.DataColumn

Public Sub New (columnName As String)

Parâmetros

columnName

String

Uma cadeia de caracteres que representa o nome da coluna a ser criada. Se definido como null ou uma cadeia de caracteres vazia (""), um nome padrão será especificado quando adicionado à coleção de colunas.

Exemplos

O exemplo a seguir cria um novo DataColumn com um .ColumnName

private void AddDataColumn(DataTable table)
{
    DataColumn column = new DataColumn("id");

    // Set various properties.
    column.DataType = System.Type.GetType("System.Int32");
    column.AutoIncrement = true;
    column.AutoIncrementSeed = 1;
    column.AutoIncrementStep = 1;
    column.ReadOnly = true;

    // Add to Columns collection.
    table.Columns.Add(column);
}

Private Sub AddDataColumn(ByVal table As DataTable)
    Dim column As DataColumn 
    column = New DataColumn("id")

    ' Set various properties.
    With column
       .DataType = System.Type.GetType("System.Int32")
       .AutoIncrement = True
       .AutoIncrementSeed = 1
       .AutoIncrementStep = 1
       .ReadOnly = True
     End With

    ' Add to Columns collection.
    table.Columns.Add(column)
End Sub

Comentários

Por padrão, o nome específico de uma coluna se torna o valor da Caption propriedade.

Confira também

• ColumnName
• Caption
• DefaultValue
• DataTable
• DataType
• Usando Conjuntos de Dados no ADO.NET

DataColumn(String, Type)

Origem:

DataColumn.cs

Inicializa uma nova instância da DataColumn classe usando o nome da coluna e o tipo de dados especificados.

public:
 DataColumn(System::String ^ columnName, Type ^ dataType);

public DataColumn(string? columnName, Type dataType);

new System.Data.DataColumn : string * Type -> System.Data.DataColumn

Public Sub New (columnName As String, dataType As Type)

Parâmetros

columnName

String

Uma cadeia de caracteres que representa o nome da coluna a ser criada. Se definido como null ou uma cadeia de caracteres vazia (""), um nome padrão será especificado quando adicionado à coleção de colunas.

dataType

Type

Um suporte DataType.

Exceções

ArgumentNullException

Não dataType foi especificado.

Exemplos

O exemplo a seguir cria um novo DataColumn com um especificado ColumnName e DataType.

private void AddDataColumn(DataTable table)
{
    System.Type typeInt32 =
        System.Type.GetType("System.Int32");
    DataColumn column = new DataColumn("id", typeInt32);

    // Set various properties.
    column.AutoIncrement = true;
    column.AutoIncrementSeed = 1;
    column.AutoIncrementStep = 1;
    column.ReadOnly = true;

    // Add to Columns collection.
    table.Columns.Add(column);
}

Private Sub AddDataColumn(ByVal table As DataTable)
    
   Dim typeInt32 As System.Type = _
      System.Type.GetType("System.Int32")
   Dim column As DataColumn = _
       New DataColumn("id", typeInt32)

   ' Set various properties.
   With column
      .AutoIncrement = True
      .AutoIncrementSeed = 1
      .AutoIncrementStep = 1
      .ReadOnly = True
    End With

   ' Add to Columns collection.
   table.Columns.Add(column)
End Sub

Confira também

• DefaultValue
• ColumnName
• Caption
• DataTable
• DataType
• Usando Conjuntos de Dados no ADO.NET

DataColumn(String, Type, String)

Origem:

DataColumn.cs

Inicializa uma nova instância da DataColumn classe usando o nome, o tipo de dados e a expressão especificados.

public:
 DataColumn(System::String ^ columnName, Type ^ dataType, System::String ^ expr);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types or types used in expressions may be trimmed if not referenced directly.")]
public DataColumn(string? columnName, Type dataType, string? expr);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types or types used in expressions may be trimmed if not referenced directly.")>]
new System.Data.DataColumn : string * Type * string -> System.Data.DataColumn

Public Sub New (columnName As String, dataType As Type, expr As String)

Parâmetros

columnName

String

Uma cadeia de caracteres que representa o nome da coluna a ser criada. Se definido como null ou uma cadeia de caracteres vazia (""), um nome padrão será especificado quando adicionado à coleção de colunas.

dataType

Type

Um suporte DataType.

expr

String

A expressão usada para criar esta coluna. Para obter mais informações, consulte a propriedade Expression.

Atributos

RequiresUnreferencedCodeAttribute

Exceções

ArgumentNullException

Não dataType foi especificado.

Exemplos

O exemplo a seguir cria uma coluna computada.

private void AddDataColumn(DataTable table)
{
    System.Type decimalType;
    decimalType = System.Type.GetType("System.Decimal");

    // Create the column. The name is 'Tax,' with data type Decimal,and
    // an expression ('UnitPrice * .0862) to calculate the tax.
    DataColumn column = new DataColumn("Tax",
        decimalType, "UnitPrice * .0862");

    // Set various properties.
    column.AutoIncrement = false;
    column.ReadOnly = true;

    // Add to Columns collection.;
    table.Columns.Add(column);
}

Private Sub AddDataColumn(ByVal table As DataTable)
    Dim column As DataColumn 
    Dim decimalType As System.Type
 
    decimalType = System.Type.GetType("System.Decimal")
    column = New DataColumn("Tax", decimalType, "UnitPrice * .0862")

    ' Set various properties.
    With column
       .AutoIncrement = False
       .ReadOnly = True
    End With

    ' Add to Columns collection.
    table.Columns.Add(column)
 End Sub

Confira também

• DefaultValue
• ColumnName
• Caption
• DataTable
• DataType
• Expression
• Usando Conjuntos de Dados no ADO.NET

DataColumn(String, Type, String, MappingType)

Origem:

DataColumn.cs

Inicializa uma nova instância da DataColumn classe usando o nome, o tipo de dados, a expressão e o valor especificados que determina se a coluna é um atributo.

public:
 DataColumn(System::String ^ columnName, Type ^ dataType, System::String ^ expr, System::Data::MappingType type);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types or types used in expressions may be trimmed if not referenced directly.")]
public DataColumn(string? columnName, Type dataType, string? expr, System.Data.MappingType type);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types or types used in expressions may be trimmed if not referenced directly.")>]
new System.Data.DataColumn : string * Type * string * System.Data.MappingType -> System.Data.DataColumn

Public Sub New (columnName As String, dataType As Type, expr As String, type As MappingType)

Parâmetros

columnName

String

Uma cadeia de caracteres que representa o nome da coluna a ser criada. Se definido como null ou uma cadeia de caracteres vazia (""), um nome padrão será especificado quando adicionado à coleção de colunas.

dataType

Type

Um suporte DataType.

expr

String

A expressão usada para criar esta coluna. Para obter mais informações, consulte a propriedade Expression.

type

MappingType

Um dos MappingType valores.

Atributos

RequiresUnreferencedCodeAttribute

Exceções

ArgumentNullException

Não dataType foi especificado.

Exemplos

O exemplo a seguir constrói uma coluna computada.

private void CreateComputedColumn(DataTable table)
{
    System.Type myDataType =
        System.Type.GetType("System.Decimal");

    // The expression multiplies the "Price" column value
    // by the "Quantity" to create the "Total" column.
    string expression = "Price * Quantity";

    // Create the column, setting the type to Attribute.
    DataColumn column = new DataColumn("Total", myDataType,
        expression, MappingType.Attribute);

    // Set various properties.
    column.AutoIncrement = false;
    column.ReadOnly = true;

    // Add the column to a DataTable object's to DataColumnCollection.
    DataSet1.Tables["OrderDetails"].Columns.Add(column);
}

Private Sub CreateComputedColumn(ByVal table As DataTable)
    Dim column As DataColumn
    Dim decimalType As System.Type = _
        System.Type.GetType("System.Decimal")

    ' The expression multiplies the "Price" column value by the 
    ' "Quantity" to create the "Total" column.
    Dim expression As String = "Price * Quantity"

    ' Create the column, setting the type to Attribute.
    column = New DataColumn("Total", decimalType, _
        expression, MappingType.Attribute)

    ' Set various properties.
    column.AutoIncrement = False
    column.ReadOnly = True

    ' Add the column to a DataTable object's DataColumnCollection.
    DataSet1.Tables("OrderDetails").Columns.Add(column)
End Sub

Comentários

O type argumento define a ColumnMapping propriedade. A propriedade especifica como um DataColumn é mapeado quando um DataSet é transformado em um documento XML. Por exemplo, se a coluna for denominada "fName" e o valor que ela contém for "Bob" e type for definido como MappingType.Attribute, o elemento XML será o seguinte:

<Nome fName = 'Bob'/>

Para obter mais informações sobre como as colunas são mapeadas para elementos ou atributos, consulte a ColumnMapping propriedade.

Confira também

• ColumnName
• ColumnMapping
• Caption
• DefaultValue
• DataTable
• DataType
• Usando Conjuntos de Dados no ADO.NET