DataTableCollection.Add Метод

Определение

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

Перегрузки

Имя Описание
Add()

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

Add(DataTable)

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

Add(String)

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

Add(String, String)

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

Add()

Исходный код:
DataTableCollection.cs
Исходный код:
DataTableCollection.cs
Исходный код:
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 объекта DataTableCollectionAdd .

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
Исходный код:
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
Исходный код:
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
Исходный код:
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 если таблица успешно добавлена в коллекцию.

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

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