DataTableCollection.Add Metod

Definition

Namnområde:: System.Data

Sammansättning:: System.Data.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Lägger till ett DataTable objekt i samlingen.

Överlagringar

Name	Description
Add()	Skapar ett nytt DataTable objekt med ett standardnamn och lägger till det i samlingen.
Add(DataTable)	Lägger till den angivna `DataTable` i samlingen.
Add(String)	Skapar ett DataTable objekt med det angivna namnet och lägger till det i samlingen.
Add(String, String)	Skapar ett DataTable objekt med det angivna namnet och lägger till det i samlingen.

Add()

Skapar ett nytt DataTable objekt med ett standardnamn och lägger till det i samlingen.

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

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

public virtual System.Data.DataTable Add();

public System.Data.DataTable Add();

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

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

Public Overridable Function Add () As DataTable

Public Function Add () As DataTable

Returer

DataTable

Den nyligen skapade DataTable.

Exempel

I följande exempel läggs tre nya DataTable objekt till DataTableCollection med metoden Add utan argument.

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

Kommentarer

Eftersom inget namn har angetts DataTable skapas det med hjälp av ett standardnamn i förhållande till dess tilläggsordning. Standardnamnet är "Table1".

Händelsen CollectionChanged inträffar när en tabell har lagts till i samlingen.

Se även

Gäller för

Add(DataTable)

Lägger till den angivna DataTable i samlingen.

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

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

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

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

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

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

Public Overridable Sub Add (table As DataTable)

Public Sub Add (table As DataTable)

Parametrar

table: DataTable

Objektet som DataTable ska läggas till.

Undantag

ArgumentNullException

Värdet som anges för tabellen är null.

ArgumentException

Tabellen tillhör redan den här samlingen eller tillhör en annan samling.

DuplicateNameException

En tabell i samlingen har samma namn. Jämförelsen är inte skiftlägeskänslig.

Exempel

I följande exempel skapas en DataTable och läggs till i DataTableCollection en 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);
}

Kommentarer

Händelsen CollectionChanged inträffar när en tabell har lagts till i samlingen.

Se även

Gäller för

Add(String)

Skapar ett DataTable objekt med det angivna namnet och lägger till det i samlingen.

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

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

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

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

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

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

Public Overridable Function Add (name As String) As DataTable

Public Function Add (name As String) As DataTable

Parametrar

name: String

Namnet som ska ge den skapade DataTable.

Returer

DataTable

Den nyligen skapade DataTable.

Undantag

DuplicateNameException

En tabell i samlingen har samma namn. (Jämförelsen är inte skiftlägeskänslig.)

Exempel

I följande exempel läggs ett DataTable med det angivna namnet till 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

Kommentarer

Om antingen null eller en tom sträng ("") skickas, ges ett standardnamn till den nyligen skapade DataTable. Det här namnet baseras på den ordning i vilken tabellen lades till ("Table1", "Table2" och så vidare).

Händelsen CollectionChanged inträffar om tabellen har lagts till i samlingen.

Se även

Gäller för

Add(String, String)

Skapar ett DataTable objekt med det angivna namnet och lägger till det i samlingen.

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

Parametrar

name: String

Namnet som ska ge den skapade DataTable.

tableNamespace: String

Namnområdet som ska ge den skapade DataTable.

Returer

DataTable

Den nyligen skapade DataTable.

Undantag

DuplicateNameException

En tabell i samlingen har samma namn. (Jämförelsen är inte skiftlägeskänslig.)

Exempel

I följande exempel läggs ett DataTable med det angivna namnet till 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

Kommentarer

Händelsen CollectionChanged inträffar om tabellen har lagts till i samlingen.

Se även

Gäller för

Feedback

Var den här sidan till hjälp?