DataTableCollection.Add Метод

Определение

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

System.Data

Сборка:

System.Data.Common.dll

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

Перегрузки

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

Add()

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

DataTableCollection.cs

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

public:
 System::Data::DataTable ^ Add();

public System.Data.DataTable Add ();

member this.Add : unit -> System.Data.DataTable

Public Function Add () As DataTable

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

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 событие возникает при успешном добавлении таблицы в коллекцию.

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

• DataTable
• Remove(DataTable)
• Clear()

Add(DataTable)

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

DataTableCollection.cs

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

public:
 void Add(System::Data::DataTable ^ table);

public void Add (System.Data.DataTable table);

member this.Add : System.Data.DataTable -> unit

Public Sub Add (table As DataTable)

Параметры

table

DataTable

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

Исключения

ArgumentNullException

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

ArgumentException

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

DuplicateNameException

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

Примеры

В следующем примере создается 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 событие возникает при успешном добавлении таблицы в коллекцию.

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

• DataTable
• Remove(DataTable)
• Clear()

Add(String)

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

DataTableCollection.cs

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

public:
 System::Data::DataTable ^ Add(System::String ^ name);

public System.Data.DataTable Add (string? name);

member this.Add : string -> System.Data.DataTable

Public Function Add (name As String) As DataTable

Параметры

name

String

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

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

DataTable

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

Исключения

DuplicateNameException

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

Примеры

В следующем примере добавляется 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 событие возникает, если таблица успешно добавлена в коллекцию.

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

• DataTable
• Remove(DataTable)
• Clear()

Add(String, String)

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

DataTableCollection.cs

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

public:
 System::Data::DataTable ^ Add(System::String ^ name, System::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.

Исключения

DuplicateNameException

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

Примеры

В следующем примере добавляется 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 событие возникает, если таблица успешно добавлена в коллекцию.

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

• DataTable
• Remove(DataTable)
• Clear()