BindingSource.RemoveAt メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

BindingSource.RemoveAt メソッド

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

リスト内の指定したインデックスにある項目を削除します。

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

Visual Basic (宣言)

Public Overridable Sub RemoveAt
 ( _
    index As Integer _
)

Visual Basic (使用法)

Dim instance As BindingSource
Dim index As Integer

instance.RemoveAt(index)

public virtual void RemoveAt (
    int index
)

C++

public:
virtual void RemoveAt (
    int index
)

public void RemoveAt (
    int index
)

JScript

public function RemoveAt (
    index : int
)

パラメータ

index: 削除する項目の 0 から始まるインデックス。

例外

例外の種類	条件
ArgumentOutOfRangeException	index が 0 未満か、または Count プロパティの値を上回っています。
NotSupportedException	List プロパティで表される基底のリストが、読み取り専用、または固定サイズです。

解説

これらの 2 つの条件を確認するには、それぞれ IsFixedSize プロパティと IsReadOnly プロパティを使用します。

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

使用例

List、RemoveAt、および Count の各メンバのコード例を次に示します。この例を実行するには、BindingSource1 という名前の BindingSource を持ち、label1 と label2 という名前の 2 つのラベル、および button1 という名前のボタンが配置されているフォームにコードを貼り付けます。次に、button1_Click メソッドを button1 の Click イベントに関連付けます。Visual Basic を使用する場合、System.Data.dll への参照を追加する必要があります。

Visual Basic

    Private Sub button1_Click(ByVal
 sender As Object, ByVal
 e As EventArgs) _
        Handles button1.Click

        ' Create the connection string, data adapter and data table.
        Dim connectionString As New
 SqlConnection("Initial Catalog=Northwind;" &
 _
            "Data Source=localhost;Integrated Security=SSPI;")
        Dim customersTableAdapter As New
 SqlDataAdapter("Select * from Customers", _
            connectionString)
        Dim customerTable As New
 DataTable()

        ' Fill the the adapter with the contents of the customer table.
        customersTableAdapter.Fill(customerTable)

        ' Set data source for BindingSource1.
        BindingSource1.DataSource = customerTable

        ' Set the label text to the number of items in the collection
 before
        ' an item is removed.
        label1.Text = "Starting count: " + BindingSource1.Count.ToString()

        'Access the List property and remove an item.
        BindingSource1.RemoveAt(4)

        ' Show the new count.
        label2.Text = "Count after removal: " + BindingSource1.Count.ToString()

    End Sub
End Class

private void button1_Click(object sender, EventArgs
 e)
{
    // Create the connection string, data adapter and data table.
    SqlConnection connectionString =
         new SqlConnection("Initial Catalog=Northwind;"
 +
         "Data Source=localhost;Integrated Security=SSPI;");
    SqlDataAdapter customersTableAdapter =
        new SqlDataAdapter("Select * from Customers",
 connectionString);
    DataTable customerTable = new DataTable();

    // Fill the the adapter with the contents of the customer table.
    customersTableAdapter.Fill(customerTable);

    // Set data source for BindingSource1.
    BindingSource1.DataSource = customerTable;

    // Set the label text to the number of items in the collection before
    // an item is removed.
    label1.Text = "Starting count: " + BindingSource1.Count.ToString();

    //Access the List property and remove an item.
    BindingSource1.RemoveAt(4);

    // Show the new count.
    label2.Text = "Count after removal: " + BindingSource1.Count.ToString();
}