DataColumn Construtores

Definição

Inicializa uma nova instância da classe DataColumn.

Sobrecargas

DataColumn()

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

DataColumn(String)

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

DataColumn(String, Type)

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

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.

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.

DataColumn()

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 uma nova DataColumn, define várias propriedades e a 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

Aplica-se a

DataColumn(String)

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

public:
 DataColumn(System::String ^ columnName);
public DataColumn (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 for definida 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 especificado 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

Aplica-se a

DataColumn(String, Type)

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

public:
 DataColumn(System::String ^ columnName, Type ^ dataType);
public DataColumn (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 for definida como null ou uma cadeia de caracteres vazia (""), um nome padrão será especificado quando adicionado à coleção de colunas.

dataType
Type

Um DataType com suporte.

Exceções

Nenhum 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

Aplica-se a

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.

public:
 DataColumn(System::String ^ columnName, Type ^ dataType, System::String ^ expr);
public DataColumn (string? columnName, Type dataType, string? expr);
public DataColumn (string columnName, Type dataType, string expr);
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 for definida como null ou uma cadeia de caracteres vazia (""), um nome padrão será especificado quando adicionado à coleção de colunas.

dataType
Type

Um DataType com suporte.

expr
String

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

Exceções

Nenhum 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

Aplica-se a

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.

public:
 DataColumn(System::String ^ columnName, Type ^ dataType, System::String ^ expr, System::Data::MappingType type);
public DataColumn (string? columnName, Type dataType, string? expr, System.Data.MappingType type);
public DataColumn (string columnName, Type dataType, string expr, System.Data.MappingType type);
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 for definida como null ou uma cadeia de caracteres vazia (""), um nome padrão será especificado quando adicionado à coleção de colunas.

dataType
Type

Um DataType com suporte.

expr
String

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

type
MappingType

Um dos valores de MappingType.

Exceções

Nenhum 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 chamada "fName" e o valor que ela contém for "Bob" e type estiver definido como MappingType.Attribute, o elemento XML será o seguinte:

<Name 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

Aplica-se a