DataTableCollection.Add Yöntem

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kod:

System.Data.Common.dll

Koleksiyona bir DataTable nesne ekler.

Aşırı Yüklemeler

Add()	Varsayılan bir ad kullanarak yeni DataTable bir nesne oluşturur ve bunu koleksiyona ekler.
Add(DataTable)	Belirtilen DataTable öğesini koleksiyona ekler.
Add(String)	Belirtilen adı kullanarak bir DataTable nesne oluşturur ve bunu koleksiyona ekler.
Add(String, String)	Belirtilen adı kullanarak bir DataTable nesne oluşturur ve bunu koleksiyona ekler.

Add()

Kaynak:

DataTableCollection.cs

Varsayılan bir ad kullanarak yeni DataTable bir nesne oluşturur ve bunu koleksiyona ekler.

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

public System.Data.DataTable Add ();

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

Public Function Add () As DataTable

Döndürülenler

DataTable

Yeni oluşturulan DataTable.

Örnekler

Aşağıdaki örnek, bağımsız değişken olmadan yöntemini kullanarak öğesine Add üç yeni DataTable nesne DataTableCollection ekler.

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

Açıklamalar

Hiçbir ad belirtilmediğinden DataTable , ekleme sırasına göre varsayılan ad kullanılarak oluşturulur. Varsayılan ad "Tablo1"dir.

Olay, CollectionChanged bir tablo koleksiyona başarıyla eklendiğinde gerçekleşir.

Ayrıca bkz.

• DataTable
• Remove(DataTable)
• Clear()

Add(DataTable)

Kaynak:

DataTableCollection.cs

Belirtilen DataTable öğesini koleksiyona ekler.

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)

Parametreler

table

DataTable

DataTable Eklenecek nesne.

Özel durumlar

ArgumentNullException

Tablo için belirtilen değer şeklindedir null.

ArgumentException

Tablo zaten bu koleksiyona ait veya başka bir koleksiyona ait.

DuplicateNameException

Koleksiyondaki bir tablo aynı ada sahiptir. Karşılaştırma büyük/küçük harfe duyarlı değildir.

Örnekler

Aşağıdaki örnek bir DataTable oluşturur ve öğesinin DataTableCollection öğesine DataSetekler.

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

Açıklamalar

Olay, CollectionChanged bir tablo koleksiyona başarıyla eklendiğinde gerçekleşir.

Ayrıca bkz.

• DataTable
• Remove(DataTable)
• Clear()

Add(String)

Kaynak:

DataTableCollection.cs

Belirtilen adı kullanarak bir DataTable nesne oluşturur ve bunu koleksiyona ekler.

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

Parametreler

name

String

Oluşturulan DataTableöğesine vermek için gereken ad.

Döndürülenler

DataTable

Yeni oluşturulan DataTable.

Özel durumlar

DuplicateNameException

Koleksiyondaki bir tablo aynı ada sahiptir. (Karşılaştırma büyük/küçük harfe duyarlı değildir.)

Örnekler

Aşağıdaki örnek, öğesine verilen ada DataTableCollectionsahip bir DataTable ekler.

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

Açıklamalar

null veya boş bir dize ("") geçirilirse, yeni oluşturulan DataTableöğesine varsayılan bir ad verilir. Bu ad, tablonun eklenme sırasını temel alır ("Tablo1", "Tablo2", vb.).

Tablo CollectionChanged koleksiyona başarıyla eklenirse olay oluşur.

Ayrıca bkz.

• DataTable
• Remove(DataTable)
• Clear()

Add(String, String)

Kaynak:

DataTableCollection.cs

Belirtilen adı kullanarak bir DataTable nesne oluşturur ve bunu koleksiyona ekler.

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

Parametreler

name

String

Oluşturulan DataTableöğesine vermek için gereken ad.

tableNamespace

String

Oluşturulan DataTableöğesine vermek için ad alanı.

Döndürülenler

DataTable

Yeni oluşturulan DataTable.

Özel durumlar

DuplicateNameException

Koleksiyondaki bir tablo aynı ada sahiptir. (Karşılaştırma büyük/küçük harfe duyarlı değildir.)

Örnekler

Aşağıdaki örnek, öğesine verilen ada DataTableCollectionsahip bir DataTable ekler.

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

Açıklamalar

null veya boş bir dize ("") geçirilirse, yeni oluşturulan DataTableöğesine varsayılan bir ad verilir. Bu ad, tablonun eklenme sırasını temel alır ("Tablo1", "Tablo2", vb.).

Tablo CollectionChanged koleksiyona başarıyla eklenirse olay oluşur.

Ayrıca bkz.

• DataTable
• Remove(DataTable)
• Clear()