DataTable Construtores

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Inicializa uma nova instância da classe DataTable.

Sobrecargas

DataTable()	Inicializa uma nova instância da classe DataTable sem argumentos.
DataTable(String)	Inicializa uma nova instância da classe DataTable com o nome da tabela especificada.
DataTable(SerializationInfo, StreamingContext)	Obsoleto. Inicializa uma nova instância da classe DataTable com dados serializados.
DataTable(String, String)	Inicializa uma nova instância da classe DataTable usando o nome de tabela e o namespace especificados.

DataTable()

Origem:

DataTable.cs

Inicializa uma nova instância da classe DataTable sem argumentos.

C#

public DataTable ();

Exemplos

O exemplo a seguir cria um novo DataTable com DataColumn e DataRowe o exibe em um DataGridView controle .

C#

private void MakeDataTableAndDisplay()
{
    // Create new DataTable.
    DataTable table = new DataTable();

    // Declare DataColumn and DataRow variables.
    DataColumn column;
    DataRow row;

    // Create new DataColumn, set DataType, ColumnName
    // and add to DataTable.
    column = new DataColumn();
    column.DataType = System.Type.GetType("System.Int32");
    column.ColumnName = "id";
    table.Columns.Add(column);

    // Create second column.
    column = new DataColumn();
    column.DataType = Type.GetType("System.String");
    column.ColumnName = "item";
    table.Columns.Add(column);

    // Create new DataRow objects and add to DataTable.
    for(int i = 0; i < 10; i++)
    {
        row = table.NewRow();
        row["id"] = i;
        row["item"] = "item " + i;
        table.Rows.Add(row);
    }
    // Set to DataGrid.DataSource property to the table.
    dataGrid1.DataSource = table;
}

Comentários

O construtor define valores iniciais para todas as propriedades do DataTable objeto . A tabela a seguir mostra as propriedades e seus valores padrão. Quando uma instância de é criada, as propriedades de DataTable leitura/gravação a seguir são definidas como valores iniciais.

Propriedade	Valor padrão
CaseSensitive	O mesmo que o pai DataSet, se ele pertencer a um. Caso contrário, false.
DisplayExpression	Cadeia de caracteres vazia ("")
Localidade	O mesmo que o do objeto pai DataSet (retornado pela Locale propriedade ); se nenhum pai existir, o padrão será o sistema CultureInfoCultureInfo atual.
MinimumCapacity	50 linhas.

Você pode alterar o valor de qualquer uma dessas propriedades por meio de uma chamada separada para a propriedade .

Confira também

• DataTables

DataTable(String)

Origem:

DataTable.cs

Inicializa uma nova instância da classe DataTable com o nome da tabela especificada.

C#

public DataTable (string? tableName);

Parâmetros

tableName

String

O nome a ser dado à tabela. Se tableName for null ou uma cadeia de caracteres vazia, um nome padrão será fornecido quando ele for adicionado na DataTableCollection.

Exemplos

O exemplo a seguir cria um DataTable e o exibe em um DataGridView controle .

C#

private void MakeDataTableAndDisplay()
{
    // Create new DataTable.
    DataTable table = new DataTable("table");

    // Declare DataColumn and DataRow variables.
    DataColumn column;
    DataRow row;

    // Create new DataColumn, set DataType,
    // ColumnName and add to DataTable.
    column = new DataColumn();
    column.DataType = System.Type.GetType("System.Int32");
    column.ColumnName = "id";
    table.Columns.Add(column);

    // Create second column.
    column = new DataColumn();
    column.DataType = Type.GetType("System.String");
    column.ColumnName = "item";
    table.Columns.Add(column);

    // Create new DataRow objects and add to DataTable.
    for(int i = 0; i < 10; i++)
    {
        row = table.NewRow();
        row["id"] = i;
        row["item"] = "item " + i;
        table.Rows.Add(row);
    }
    // Set to DataGrid.DataSource property to the table.
    dataGrid1.DataSource = table;
}

Confira também

• DataTables

DataTable(SerializationInfo, StreamingContext)

Origem:

DataTable.cs

Cuidado

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Inicializa uma nova instância da classe DataTable com dados serializados.

C#

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected DataTable (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

Parâmetros

info

SerializationInfo

Os dados serializados para o conjunto de dados.

context

StreamingContext

Informações contextuais sobre o fluxo serializado.

Atributos

ObsoleteAttribute

Exceções

InvalidEnumArgumentException

Somente .NET 7 e versões posteriores: info contém dados binários.

Comentários

Essa implementação do DataTable construtor é necessária para ISerializable.

Confira também

• DataTables

DataTable(String, String)

Origem:

DataTable.cs

Inicializa uma nova instância da classe DataTable usando o nome de tabela e o namespace especificados.

C#

public DataTable (string? tableName, string? tableNamespace);

Parâmetros

tableName

String

O nome a ser dado à tabela. Se tableName for null ou uma cadeia de caracteres vazia, um nome padrão será fornecido quando ele for adicionado na DataTableCollection.

tableNamespace

String

Obtém o namespace para a representação XML dos dados armazenados no DataTable.

Confira também

• DataTables