DataTable Конструкторы

Определение

Пространство имен:

System.Data

Сборка:

System.Data.Common.dll

Инициализирует новый экземпляр класса DataTable.

Перегрузки

DataTable()	Инициализирует новый экземпляр класса DataTable, не передавая ему никаких аргументов.
DataTable(String)	Инициализирует новый экземпляр класса DataTable с указанным именем таблицы.
DataTable(SerializationInfo, StreamingContext)	Устаревшие.. Инициализирует новый экземпляр класса DataTable с сериализованными данными.
DataTable(String, String)	Инициализирует новый экземпляр класса DataTable с заданными именем таблицы и пространством имен.

DataTable()

Исходный код:

DataTable.cs

Инициализирует новый экземпляр класса DataTable, не передавая ему никаких аргументов.

public:
 DataTable();

public DataTable ();

Public Sub New ()

Примеры

В следующем примере создается новый DataTable объект с DataColumn помощью и DataRowи отображается в элементе DataGridView управления .

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

Комментарии

Конструктор задает начальные значения для всех свойств DataTable объекта . В следующей таблице показаны свойства и их значения по умолчанию. При создании экземпляра DataTable для следующих свойств чтения и записи устанавливаются начальные значения.

Свойство	Значение по умолчанию
CaseSensitive	То же, что и родительский DataSetобъект , если он принадлежит одному. В противном случае — значение false.
DisplayExpression	Пустая строка ("")
Локаль	Аналогично родительскому DataSet объекту (возвращается свойством Locale ); если родительский объект CultureInfo не существует, по умолчанию используется текущая система CultureInfo.
MinimumCapacity	50 строк.

Значение любого из этих свойств можно изменить с помощью отдельного вызова свойства .

См. также раздел

• DataTables

DataTable(String)

Исходный код:

DataTable.cs

Инициализирует новый экземпляр класса DataTable с указанным именем таблицы.

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

public DataTable (string? tableName);

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

Public Sub New (tableName As String)

Параметры

tableName

String

Имя, задаваемое таблице. Если значение параметра tableName — null или пустая строка, имя по умолчанию присваивается при добавлении в коллекцию DataTableCollection.

Примеры

В следующем примере создается DataTable и отображается в элементе DataGridView управления .

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

См. также раздел

• DataTables

DataTable(SerializationInfo, StreamingContext)

Исходный код:

DataTable.cs

Внимание!

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Инициализирует новый экземпляр класса DataTable с сериализованными данными.

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

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

Параметры

info

SerializationInfo

Сериализованные данные для набора данных.

context

StreamingContext

Контекстные сведения о сериализованном потоке.

Атрибуты

ObsoleteAttribute

Исключения

InvalidEnumArgumentException

Только .NET 7 и более поздних версий: info содержит двоичные данные.

Комментарии

Эта реализация конструктора является обязательной DataTable для ISerializable.

См. также раздел

• DataTables

DataTable(String, String)

Исходный код:

DataTable.cs

Инициализирует новый экземпляр класса DataTable с заданными именем таблицы и пространством имен.

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)

Параметры

tableName

String

Имя, задаваемое таблице. Если значение параметра tableName — null или пустая строка, имя по умолчанию присваивается при добавлении в коллекцию DataTableCollection.

tableNamespace

String

Пространство имен для XML-представления данных, хранящихся в DataTable.

См. также раздел

• DataTables