DataTable Construtores

Definição

Espaço de Nomes:: System.Data

Assemblagem:: System.Data.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da DataTable classe.

Sobrecargas

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

DataTable()

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

public:
 DataTable();

public DataTable();

Public Sub New ()

Exemplos

O exemplo seguinte cria um novo DataTable com DataColumn e DataRow, e apresenta-o num DataGridView controlo.

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

Observações

O construtor define valores iniciais para todas as propriedades do DataTable objeto. A tabela seguinte mostra as propriedades e os seus valores padrão. Quando uma instância de DataTable é criada, as seguintes propriedades de leitura/escrita são definidas para valores iniciais.

Property	Valor predefinido
Case Sensitive	Igual ao pai, DataSetse pertencer a um. Caso contrário, `false`.
DisplayExpression	Corda vazia ("")
Locale	Igual ao do objeto CultureInfo pai DataSet (devolvido pela Locale propriedade); se não existir um pai, o padrão é o sistema CultureInfoatual .
Capacidade Mínima	50 filas.

Pode alterar o valor de qualquer uma destas propriedades através de uma chamada separada para a propriedade.

Ver também

Tabelas de dados

Aplica-se a

DataTable(String)

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

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 para dar à mesa. Se tableName for null ou uma cadeia vazia, um nome por defeito é dado quando adicionado ao DataTableCollection.

Exemplos

O exemplo seguinte cria um DataTable e apresenta-o num DataGridView controlo.

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

Ver também

Tabelas de dados

Aplica-se a

DataTable(SerializationInfo, StreamingContext)

Inicializa uma nova instância da DataTable classe 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ção contextual sobre o fluxo serializado.

Exceções

InvalidEnumArgumentException

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

Observações

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

Ver também

Tabelas de dados

Aplica-se a

DataTable(String, String)

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

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 para dar à mesa. Se tableName for null ou uma cadeia vazia, um nome por defeito é dado quando adicionado ao DataTableCollection.

tableNamespace: String

O espaço de nomes para a representação XML dos dados armazenados no DataTablearquivo .

Ver também

Tabelas de dados

Aplica-se a

Comentários

Esta página foi útil?