BindingSource.Add メソッド

.NET Framework クラス ライブラリ リファレンス

BindingSource.Add メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

既存の項目を内部リストに追加します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Overridable Function
 Add ( _
    value As Object _
) As Integer

Visual Basic (使用法)

Dim instance As BindingSource
Dim value As Object
Dim returnValue As Integer

returnValue = instance.Add(value)

C#

public virtual int Add (
    Object value
)

C++

public:
virtual int Add (
    Object^ value
)

J#

public int Add (
    Object value
)

JScript

public function Add (
    value : Object
) : int

パラメータ

value

内部リストに追加する Object。

戻り値
List プロパティで表される基底のリストに value を追加する場所の 0 から始まるインデックス。

例外

例外の種類	条件
InvalidOperationException	value の型が、基底のリストに含まれる既存の項目と異なっています。

解説

Add メソッドは、呼び出しを基底のリストの Add メソッドに参照します。

内部リストには、同じ種類の型を格納する必要があります。DataSource プロパティがまだ設定されていない場合は、リストに追加される最初のオブジェクトによってリストの型が決定されます。

このメソッドは、ListChanged イベントを発生させます。

使用例

BindingSource コンポーネントを使用して、リストを DataGridView コントロールにバインドするコード例を次に示します。リストは、Add メソッドを呼び出すことによって設定されます。

次のコード例は、「方法 : BindingSource ResetItem メソッドを使用して変更通知を発生させる」で示されている例の一部です。

Visual Basic

Private Sub Form1_Load(ByVal
 sender As System.Object, _
    ByVal e As System.EventArgs) Handles
 Me.Load
    ' Create and populate the list of DemoCustomer objects
    ' which will supply data to the DataGridView.
    Dim customerList As List(Of
 DemoCustomer) = _
    New List(Of DemoCustomer)
    customerList.Add(DemoCustomer.CreateNewCustomer())
    customerList.Add(DemoCustomer.CreateNewCustomer())
    customerList.Add(DemoCustomer.CreateNewCustomer())

    ' Bind the list to the BindingSource.
    Me.customersBindingSource.DataSource = customerList

    ' Attach the BindingSource to the DataGridView.
    Me.customersDataGridView.DataSource = Me.customersBindingSource
End Sub

C#

private void Form1_Load(System.Object sender,
 System.EventArgs e)
{
    // Create and populate the list of DemoCustomer objects
    // which will supply data to the DataGridView.
    List<DemoCustomer> customerList = new List<DemoCustomer>();
    customerList.Add(DemoCustomer.CreateNewCustomer());
    customerList.Add(DemoCustomer.CreateNewCustomer());
    customerList.Add(DemoCustomer.CreateNewCustomer());

    // Bind the list to the BindingSource.
    this.customersBindingSource.DataSource = customerList;

    
    // Attach the BindingSource to the DataGridView.
    this.customersDataGridView.DataSource = 
        this.customersBindingSource;
}

C++

void Form1_Load( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   // Create and populate the list of DemoCustomer objects
   // which will supply data to the DataGridView.
   List< DemoCustomer^ >^ customerList = gcnew List< DemoCustomer^ >;
   customerList->Add( DemoCustomer::CreateNewCustomer() );
   customerList->Add( DemoCustomer::CreateNewCustomer() );
   customerList->Add( DemoCustomer::CreateNewCustomer() );
   
   // Bind the list to the BindingSource.
   this->customersBindingSource->DataSource = customerList;
   
   // Handle the ListChanged event.
   this->customersBindingSource->ListChanged +=
      gcnew ListChangedEventHandler(
         this, &Form1::customersBindingSource_ListChanged
 );
   
   // Attach the BindingSource to the DataGridView.
   this->customersDataGridView->DataSource =
      this->customersBindingSource;
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
BindingSource クラス
BindingSource メンバ
System.Windows.Forms 名前空間
List
Position
AddNew
Remove
RemoveCurrent
Insert