DataTableCollection.Add Метод

Определение

Добавляет объект DataTable в коллекцию.

Перегрузки

Add()

Создает новый объект DataTable, используя имя по умолчанию, и добавляет его в коллекцию.

Add(DataTable)

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

Add(String)

Создает объект DataTable, используя заданное имя, и добавляет его в коллекцию.

Add(String, String)

Создает объект DataTable, используя заданное имя, и добавляет его в коллекцию.

Add()

Исходный код:
DataTableCollection.cs
Исходный код:
DataTableCollection.cs
Исходный код:
DataTableCollection.cs

Создает новый объект DataTable, используя имя по умолчанию, и добавляет его в коллекцию.

public:
 System::Data::DataTable ^ Add();
public:
 virtual System::Data::DataTable ^ Add();
public System.Data.DataTable Add ();
public virtual System.Data.DataTable Add ();
member this.Add : unit -> System.Data.DataTable
abstract member Add : unit -> System.Data.DataTable
override this.Add : unit -> System.Data.DataTable
Public Function Add () As DataTable
Public Overridable Function Add () As DataTable

Возвращаемое значение

Вновь созданный DataTable.

Примеры

В следующем примере три новых DataTable объекта добавляются в с DataTableCollection помощью Add метода без аргументов.

private void AddTables()
{
    // Presuming a DataGrid is displaying more than one table,
    // get its DataSet.
    DataSet thisDataSet = (DataSet)DataGrid1.DataSource;

    for (int i = 0; i < 3; i++)
        thisDataSet.Tables.Add();
    Console.WriteLine(thisDataSet.Tables.Count.ToString()
        + " tables");
    foreach (DataTable table in thisDataSet.Tables)
        Console.WriteLine(table.TableName);
}
Private Sub AddTables()
   Dim table As DataTable
   
   ' Presuming a DataGrid is displaying more than one table, get its DataSet.
   Dim thisDataSet As DataSet = CType(DataGrid1.DataSource, DataSet)
   Dim i As Integer
   For i = 0 to 2
      thisDataSet.Tables.Add()
   Next i

   Console.WriteLine(thisDataSet.Tables.Count.ToString() & " tables")
   For Each table In thisDataSet.Tables
      Console.WriteLine(table.TableName)
   Next
End Sub

Комментарии

Так как имя не указано, DataTable создается с использованием имени по умолчанию относительно порядка сложения. Имя по умолчанию — Table1.

Это CollectionChanged событие возникает при успешном добавлении таблицы в коллекцию.

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

Применяется к

Add(DataTable)

Исходный код:
DataTableCollection.cs
Исходный код:
DataTableCollection.cs
Исходный код:
DataTableCollection.cs

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

public:
 void Add(System::Data::DataTable ^ table);
public:
 virtual void Add(System::Data::DataTable ^ table);
public void Add (System.Data.DataTable table);
public virtual void Add (System.Data.DataTable table);
member this.Add : System.Data.DataTable -> unit
abstract member Add : System.Data.DataTable -> unit
override this.Add : System.Data.DataTable -> unit
Public Sub Add (table As DataTable)
Public Overridable Sub Add (table As DataTable)

Параметры

table
DataTable

Добавляемый объект DataTable.

Исключения

Значением, заданным для таблицы, является null.

Таблица уже принадлежит данной или другой коллекции.

Таблица в коллекции имеет такое же имя. Сравнение выполняется без учета регистра.

Примеры

В следующем примере создается DataTable и добавляется в DataTableCollection объект DataSet.

private void AddDataTable()
{
    // Get the DataTableCollection of a DataGrid
    // control's DataSet.
    DataTableCollection tables =
        ((DataSet)DataGrid1.DataSource).Tables;

    // Create a new DataTable.
    DataTable table = new DataTable();

    // Code to add columns and rows not shown here.

    // Add the table to the DataTableCollection.
    tables.Add(table);
}

Комментарии

Это CollectionChanged событие возникает при успешном добавлении таблицы в коллекцию.

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

Применяется к

Add(String)

Исходный код:
DataTableCollection.cs
Исходный код:
DataTableCollection.cs
Исходный код:
DataTableCollection.cs

Создает объект DataTable, используя заданное имя, и добавляет его в коллекцию.

public:
 System::Data::DataTable ^ Add(System::String ^ name);
public:
 virtual System::Data::DataTable ^ Add(System::String ^ name);
public System.Data.DataTable Add (string? name);
public System.Data.DataTable Add (string name);
public virtual System.Data.DataTable Add (string name);
member this.Add : string -> System.Data.DataTable
abstract member Add : string -> System.Data.DataTable
override this.Add : string -> System.Data.DataTable
Public Function Add (name As String) As DataTable
Public Overridable Function Add (name As String) As DataTable

Параметры

name
String

Имя, задаваемое созданному объекту DataTable.

Возвращаемое значение

Вновь созданный DataTable.

Исключения

Таблица в коллекции имеет такое же имя. (Сравнение выполняется без учета регистра).

Примеры

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

private void AddTable()
{
    // Presuming a DataGrid is displaying more than one table,
    // get its DataSet.
    DataSet thisDataSet = (DataSet)DataGrid1.DataSource;

    // Use the Add method to add a new table with a given name.
    DataTable table = thisDataSet.Tables.Add("NewTable");

    // Code to add columns and rows not shown here.

    Console.WriteLine(table.TableName);
    Console.WriteLine(thisDataSet.Tables.Count.ToString());
}
Private Sub AddTable()
    ' Presuming a DataGrid is displaying more than one table, 
    ' get its DataSet.
    Dim thisDataSet As DataSet = _
        CType(DataGrid1.DataSource, DataSet)

    ' Use the Add method to add a new table with a given name.
    Dim table As DataTable = thisDataSet.Tables.Add("NewTable")

    ' Code to add columns and rows not shown here.

    Console.WriteLine(table.TableName)
    Console.WriteLine(thisDataSet.Tables.Count.ToString())
End Sub

Комментарии

Если передается либо null пустая строка (""), то только что созданному DataTableобъекту присваивается имя по умолчанию . Это имя основано на порядке добавления таблицы ("Table1", "Table2" и т. д.).

Это CollectionChanged событие возникает, если таблица успешно добавлена в коллекцию.

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

Применяется к

Add(String, String)

Исходный код:
DataTableCollection.cs
Исходный код:
DataTableCollection.cs
Исходный код:
DataTableCollection.cs

Создает объект DataTable, используя заданное имя, и добавляет его в коллекцию.

public:
 System::Data::DataTable ^ Add(System::String ^ name, System::String ^ tableNamespace);
public System.Data.DataTable Add (string? name, string? tableNamespace);
public System.Data.DataTable Add (string name, string tableNamespace);
member this.Add : string * string -> System.Data.DataTable
Public Function Add (name As String, tableNamespace As String) As DataTable

Параметры

name
String

Имя, задаваемое созданному объекту DataTable.

tableNamespace
String

Пространство имен, задаваемое созданному объекту DataTable.

Возвращаемое значение

Вновь созданный DataTable.

Исключения

Таблица в коллекции имеет такое же имя. (Сравнение выполняется без учета регистра).

Примеры

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

private void AddTable()
{
    // Presuming a DataGrid is displaying more than one table,
    // get its DataSet.
    DataSet thisDataSet = (DataSet)DataGrid1.DataSource;

    // Use the Add method to add a new table with a given name.
    DataTable table = thisDataSet.Tables.Add("NewTable");

    // Code to add columns and rows not shown here.

    Console.WriteLine(table.TableName);
    Console.WriteLine(thisDataSet.Tables.Count.ToString());
}
Private Sub AddTable()
    ' Presuming a DataGrid is displaying more than one table, 
    ' get its DataSet.
    Dim thisDataSet As DataSet = _
        CType(DataGrid1.DataSource, DataSet)

    ' Use the Add method to add a new table with a given name.
    Dim table As DataTable = thisDataSet.Tables.Add("NewTable")

    ' Code to add columns and rows not shown here.

    Console.WriteLine(table.TableName)
    Console.WriteLine(thisDataSet.Tables.Count.ToString())
End Sub

Комментарии

Если передается либо null пустая строка (""), то только что созданному DataTableобъекту присваивается имя по умолчанию . Это имя основано на порядке добавления таблицы ("Table1", "Table2" и т. д.).

Это CollectionChanged событие возникает, если таблица успешно добавлена в коллекцию.

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

Применяется к