DataTableCollection.Add メソッド (String)

指定した名前で DataTable オブジェクトを作成し、このオブジェクトをコレクションに追加します。

Overloads Public Overridable Function Add( _
   ByVal name As String _) As DataTable
[C#]
public virtual DataTable Add(stringname);
[C++]
public: virtual DataTable* Add(String* name);
[JScript]
public function Add(
   name : String) : DataTable;

パラメータ

• name
  作成した DataTable に付ける名前。

戻り値

新しく作成した DataTable 。

例外

例外の種類	条件
DuplicateNameException	コレクション内に同じ名前のテーブルがあります。比較では、大文字と小文字が区別されません。

解説

null 参照 (Visual Basic では Nothing) 参照または空の文字列 ("") のどちらかが渡された場合は、新しく作成した DataTable に既定の名前が付けられます。この名前は、テーブルの追加順序に基づいて付けられます (Table1、Table2 など)。

OnCollectionChanged イベントは、テーブルがコレクションに正常に追加されたときに発生します。

使用例

[Visual Basic, C#, C++] 指定した名前で DataTable を DataTableCollection に追加する例を次に示します。

 
Private Sub AddTable()
   Dim dSet As DataSet
   Dim dt As DataTable
   ' Presuming a DataGrid is displaying more than one table, get its DataSet.
   dSet = CType(DataGrid1.DataSource, DataSet)
   ' Use the Add method to add a new table with a given name.
   dt = dSet.Tables.Add("myNewTable")
   ' Code to add columns and rows not shown here.
   MessageBox.Show(dt.TableName)
   MessageBox.Show(dSet.Tables.Count.ToString())
End Sub

[C#] 
private void AddTable()
{
   DataSet dSet;
   DataTable dt;
   // Presuming a DataGrid is displaying more than one table, get its DataSet.
   dSet = (DataSet)DataGrid1.DataSource;
   // Use the Add method to add a new table with a given name.
   dt = dSet.Tables.Add("myNewTable");
   // Code to add columns and rows not shown here.
   MessageBox.Show(dt.TableName);
   MessageBox.Show(dSet.Tables.Count.ToString());
}

[C++] 
private:
 void AddTable()
 {
    DataSet* dSet;
    DataTable* dt;
    // Presuming a DataGrid is displaying more than one table, get its DataSet.
    dSet = dynamic_cast<DataSet*>(DataGrid1->DataSource);
    // Use the Add method to add a new table with a given name.
    dt = dSet->Tables->Add(S"myNewTable");
    // Code to add columns and rows not shown here.
    MessageBox::Show(dt->TableName);
    MessageBox::Show(dSet->Tables->Count.ToString());
 }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

DataTableCollection クラス | DataTableCollection メンバ | System.Data 名前空間 | DataTableCollection.Add オーバーロードの一覧 | DataTable | Remove | Clear