Compartilhar via


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

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

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

Exceções

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

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

Aplica-se a