DataTable Construtores

Referência

Definição

Namespace:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Origem:: DataTable.cs

Origem:: DataTable.cs

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

public:
 DataTable();

public DataTable ();

Public Sub New ()

Exemplos

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

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

Private Sub MakeDataTableAndDisplay()
   ' Create new DataTable.
   Dim table As New DataTable

   ' Declare DataColumn and DataRow variables.
   Dim column As DataColumn
   Dim row As DataRow

   ' 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.    
   Dim i As Integer
   For i = 0 To 10
      row = table.NewRow
      row("id") = i
      row("item") = "item " & i
      table.Rows.Add(row)
   Next i

   ' Set to DataGrid.DataSource property to the table.
   DataGrid1.DataSource = table
End Sub

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

Aplica-se a

DataTable(String)

Origem:: DataTable.cs

Origem:: DataTable.cs

Origem:: DataTable.cs

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

public:
 DataTable(System::String ^ tableName);

public DataTable (string? tableName);

public DataTable (string tableName);

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

Public Sub New (tableName As String)

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 .

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

Private Sub MakeDataTableAndDisplay()
   ' Create new DataTable.
   Dim table As New DataTable("table")

   ' Declare DataColumn and DataRow variables.
   Dim column As DataColumn
   Dim row As DataRow

   ' 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.    
   Dim i As Integer
   For i = 0 To 10
      row = table.NewRow
      row("id") = i
      row("item") = "item " & i
      table.Rows.Add(row)
   Next i

   ' Set to DataGrid.DataSource property to the table.
   DataGrid1.DataSource = table
End Sub

Confira também

DataTables

Aplica-se a

DataTable(SerializationInfo, StreamingContext)

Origem:: DataTable.cs

Origem:: DataTable.cs

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.

protected:
 DataTable(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

protected DataTable (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

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

new System.Data.DataTable : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Data.DataTable

[<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}")>]
new System.Data.DataTable : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Data.DataTable

Protected Sub New (info As SerializationInfo, context As StreamingContext)

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

Aplica-se a

DataTable(String, String)

Origem:: DataTable.cs

Origem:: DataTable.cs

Origem:: DataTable.cs

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

public:
 DataTable(System::String ^ tableName, System::String ^ tableNamespace);

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

public DataTable (string tableName, string tableNamespace);

new System.Data.DataTable : string * string -> System.Data.DataTable

Public Sub New (tableName As String, tableNamespace As String)

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

Aplica-se a

Partilhar via

DataTable Construtores

Definição

Sobrecargas

DataTable()

Exemplos

Comentários

Confira também

Aplica-se a

DataTable(String)

Parâmetros

Exemplos

Confira também

Aplica-se a

DataTable(SerializationInfo, StreamingContext)

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

DataTable(String, String)

Parâmetros

Confira também

Aplica-se a

Recursos adicionais