DataTable Construtores

Definição

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)

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

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 DataRowo 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 é 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 pertencer a um. Caso contrário, false.
DisplayExpression Cadeia de caracteres vazia ("")
Localidade O mesmo que CultureInfo o objeto pai DataSet (retornado pela Locale propriedade); se nenhum pai existir, o padrão será o sistema CultureInfoatual.
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

Aplica-se a

DataTable(String)

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

Aplica-se a

DataTable(SerializationInfo, StreamingContext)

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

Exceções

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

Comentários

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

Confira também

Aplica-se a

DataTable(String, String)

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

Aplica-se a