DataTable Construtores

Definição

Inicializa uma nova instância da classe DataTable.Initializes a new instance of the DataTable class.

Sobrecargas

DataTable()

Inicializa uma nova instância da classe DataTable sem argumentos.Initializes a new instance of the DataTable class with no arguments.

DataTable(String)

Inicializa uma nova instância da classe DataTable com o nome da tabela especificada.Initializes a new instance of the DataTable class with the specified table name.

DataTable(SerializationInfo, StreamingContext)

Inicializa uma nova instância da classe DataTable com o SerializationInfo e o StreamingContext.Initializes a new instance of the DataTable class with the SerializationInfo and the StreamingContext.

DataTable(String, String)

Inicializa uma nova instância da classe DataTable usando o nome de tabela e o namespace especificados.Initializes a new instance of the DataTable class using the specified table name and namespace.

DataTable()

Inicializa uma nova instância da classe DataTable sem argumentos.Initializes a new instance of the DataTable class with no arguments.

public:
 DataTable();
public DataTable ();
Public Sub New ()

Exemplos

O exemplo a seguir cria uma nova DataTable com DataColumn e DataRowe a exibe em um controle de DataGridView.The following example creates a new DataTable with DataColumn and DataRow, and displays it in a DataGridView control.

   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 objeto DataTable.The constructor sets initial values for all properties of the DataTable object. A tabela a seguir mostra as propriedades e seus valores padrão.The following table shows the properties and their default values. Quando uma instância de DataTable é criada, as seguintes propriedades de leitura/gravação são definidas como valores iniciais.When an instance of DataTable is created, the following read/write properties are set to initial values.

PropriedadeProperty Valor padrãoDefault value
CaseSensitiveCaseSensitive O mesmo que o DataSetpai, se pertencer a um.Same as the parent DataSet, if it belongs to one. Caso contrário, false.Otherwise, false.
DisplayExpressionDisplayExpression Cadeia de caracteres vazia ("")Empty string ("")
LocalidadeLocale O mesmo que o CultureInfo do objeto de DataSet pai (retornado pela propriedade Locale); Se não existir nenhum pai, o padrão será o CultureInfodo sistema atual.Same as the parent DataSet object's CultureInfo (returned by the Locale property); if no parent exists, the default is the current system CultureInfo.
MinimumCapacityMinimumCapacity 50 linhas.50 rows.

Você pode alterar o valor de qualquer uma dessas propriedades por meio de uma chamada separada para a propriedade.You can change the value for any of these properties through a separate call to the property.

Veja também

DataTable(String)

Inicializa uma nova instância da classe DataTable com o nome da tabela especificada.Initializes a new instance of the DataTable class with the specified table name.

public:
 DataTable(System::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.The name to give the table. Se tableName for null ou uma cadeia de caracteres vazia, um nome padrão será fornecido quando ele for adicionado na DataTableCollection.If tableName is null or an empty string, a default name is given when added to the DataTableCollection.

Exemplos

O exemplo a seguir cria um DataTable e o exibe em um controle de DataGridView.The following example creates a DataTable and displays it in a DataGridView control.

   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

Veja também

DataTable(SerializationInfo, StreamingContext)

Inicializa uma nova instância da classe DataTable com o SerializationInfo e o StreamingContext.Initializes a new instance of the DataTable class with the SerializationInfo and the StreamingContext.

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 necessários para serializar ou desserializar um objeto.The data needed to serialize or deserialize an object.

context
StreamingContext

A origem e o destino de um determinado fluxo serializado.The source and destination of a given serialized stream.

Comentários

Essa implementação do construtor de DataTable é necessária para ISerializable.This implementation of the DataTable constructor is required for ISerializable.

Veja também

DataTable(String, String)

Inicializa uma nova instância da classe DataTable usando o nome de tabela e o namespace especificados.Initializes a new instance of the DataTable class using the specified table name and namespace.

public:
 DataTable(System::String ^ tableName, System::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.The name to give the table. Se tableName for null ou uma cadeia de caracteres vazia, um nome padrão será fornecido quando ele for adicionado na DataTableCollection.If tableName is null or an empty string, a default name is given when added to the DataTableCollection.

tableNamespace
String

Obtém o namespace para a representação XML dos dados armazenados no DataTable.The namespace for the XML representation of the data stored in the DataTable.

Veja também

Aplica-se a