DataTableCollection.Add 메서드

정의

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

오버로드

Add()

기본 이름을 사용하여 새 DataTable 개체를 만들고 컬렉션에 추가합니다.

Add(DataTable)

지정된 DataTable를 컬렉션에 추가합니다.

Add(String)

지정된 이름을 사용하여 DataTable 개체를 만들어 컬렉션에 추가합니다.

Add(String, String)

지정된 이름을 사용하여 DataTable 개체를 만들어 컬렉션에 추가합니다.

Add()

Source:
DataTableCollection.cs
Source:
DataTableCollection.cs
Source:
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입니다.

예제

다음 예제에서는 인수 없이 메서드를 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 이벤트는 테이블이 컬렉션에 성공적으로 추가될 때 발생합니다.

추가 정보

적용 대상

Add(DataTable)

Source:
DataTableCollection.cs
Source:
DataTableCollection.cs
Source:
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 에 추가 합니다 DataTableCollectionDataSet합니다.

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)

Source:
DataTableCollection.cs
Source:
DataTableCollection.cs
Source:
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입니다.

예외

컬렉션에 이름이 같은 테이블이 있는 경우. 대/소문자를 구분하지 않고 비교합니다.

예제

다음 예제에서는 지정된 이름의 를 DataTableDataTableCollection추가합니다.

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)

Source:
DataTableCollection.cs
Source:
DataTableCollection.cs
Source:
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입니다.

예외

컬렉션에 이름이 같은 테이블이 있는 경우. 대/소문자를 구분하지 않고 비교합니다.

예제

다음 예제에서는 지정된 이름의 를 DataTableDataTableCollection추가합니다.

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 이벤트는 테이블이 컬렉션에 성공적으로 추가되면 발생합니다.

추가 정보

적용 대상