DataColumn Construtores

Definição

Espaço de Nomes:: System.Data

Assemblagens:: netstandard.dll, System.Data.Common.dll

Assemblagem:: System.Data.Common.dll

Assemblagem:: System.Data.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da DataColumn classe.

Sobrecargas

Name	Description
DataColumn()	Inicializa uma nova instância da DataColumn classe como cadeia de tipos.
DataColumn(String)	Inicializa uma nova instância da DataColumn classe, como string 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, tipo de dado e expressão especificados.
DataColumn(String, Type, String, MappingType)	Inicializa uma nova instância da DataColumn classe usando o nome, tipo de dado, expressão e valor especificados que determinam se a coluna é um atributo.

DataColumn()

Origem:: DataColumn.cs

Origem:: DataColumn.cs

Origem:: DataColumn.cs

Origem:: DataColumn.cs

Origem:: DataColumn.cs

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

public:
 DataColumn();

public DataColumn();

Public Sub New ()

Exemplos

O exemplo seguinte cria um novo DataColumn, define várias propriedades e adiciona-o a 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

Observações

Quando criado, um DataColumn objeto não tem padrão ColumnName nem Caption. Quando o adiciona a um DataColumnCollection, será gerado um nome por defeito ("Column1", "Column2", e assim sucessivamente) se um nome não tiver sido atribuído ao ColumnName.

Ver também

Aplica-se a

DataColumn(String)

Origem:: DataColumn.cs

Origem:: DataColumn.cs

Origem:: DataColumn.cs

Origem:: DataColumn.cs

Origem:: DataColumn.cs

Inicializa uma nova instância da DataColumn classe, como string de tipo, usando o nome da 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 que representa o nome da coluna a ser criada. Se definido como null ou uma cadeia vazia (""), um nome padrão será especificado quando adicionado à coleção de colunas.

Exemplos

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

Observações

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

Ver também

Aplica-se a

DataColumn(String, Type)

Origem:: DataColumn.cs

Origem:: DataColumn.cs

Origem:: DataColumn.cs

Origem:: DataColumn.cs

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);

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 que representa o nome da coluna a ser criada. Se definido como null ou uma cadeia vazia (""), um nome padrão será especificado quando adicionado à coleção de colunas.

dataType: Type

Um .DataType

Exceções

ArgumentNullException

Não foi especificado.dataType

Exemplos

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

Ver também

Aplica-se a

DataColumn(String, Type, String)

Origem:: DataColumn.cs

Origem:: DataColumn.cs

Origem:: DataColumn.cs

Origem:: DataColumn.cs

Origem:: DataColumn.cs

Inicializa uma nova instância da DataColumn classe usando o nome, tipo de dado e 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);

public DataColumn(string? columnName, Type dataType, string? expr);

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

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 que representa o nome da coluna a ser criada. Se definido como null ou uma cadeia vazia (""), um nome padrão será especificado quando adicionado à coleção de colunas.

dataType: Type

Um .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 foi especificado.dataType

Exemplos

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

Ver também

Aplica-se a

DataColumn(String, Type, String, MappingType)

Origem:: DataColumn.cs

Origem:: DataColumn.cs

Origem:: DataColumn.cs

Origem:: DataColumn.cs

Origem:: DataColumn.cs

Inicializa uma nova instância da DataColumn classe usando o nome, tipo de dado, expressão e valor especificados que determinam 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);

public DataColumn(string? columnName, Type dataType, string? expr, System.Data.MappingType type);

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

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 que representa o nome da coluna a ser criada. Se definido como null ou uma cadeia vazia (""), um nome padrão será especificado quando adicionado à coleção de colunas.

dataType: Type

Um .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 foi especificado.dataType

Exemplos

O exemplo seguinte constrói uma coluna calculada.

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

Observações

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

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

Ver também

Aplica-se a

Comentários

Esta página foi útil?