DataTableCollection.Add Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Data
Bütünleştirilmiş Kod:
System.Data.Common.dll
Bütünleştirilmiş Kod:
System.Data.dll
Bütünleştirilmiş Kod:
netstandard.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
Kaynak:
DataTableCollection.cs
Kaynak:
DataTableCollection.cs

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

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

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.

Şunlara uygulanır

Add(DataTable)

Kaynak:
DataTableCollection.cs
Kaynak:
DataTableCollection.cs
Kaynak:
DataTableCollection.cs

Belirtilen DataTable öğesini koleksiyona ekler.

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)

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.

Şunlara uygulanır

Add(String)

Kaynak:
DataTableCollection.cs
Kaynak:
DataTableCollection.cs
Kaynak:
DataTableCollection.cs

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

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

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.

Şunlara uygulanır

Add(String, String)

Kaynak:
DataTableCollection.cs
Kaynak:
DataTableCollection.cs
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);
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.

Şunlara uygulanır