DataTableCollection.Add 메서드

정의

네임스페이스:

System.Data

어셈블리:

System.Data.Common.dll

컬렉션에 DataTable 개체를 추가합니다.

오버로드

Add()	기본 이름을 사용하여 새 DataTable 개체를 만들고 컬렉션에 추가합니다.
Add(DataTable)	지정된 DataTable를 컬렉션에 추가합니다.
Add(String)	지정된 이름을 사용하여 DataTable 개체를 만들어 컬렉션에 추가합니다.
Add(String, String)	지정된 이름을 사용하여 DataTable 개체를 만들어 컬렉션에 추가합니다.

Add()

Source:

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입니다.

예제

다음 예제에서는 인수 없이 메서드를 DataTableCollection 사용하여 에 세 개의 새 DataTable 개체를 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)

Source:

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)

Source:

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)

Source:

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()