BindingList.AddNew メソッド

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

BindingList.AddNew メソッド

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

コレクションに新しい項目を追加します。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Function AddNew As
 T

Visual Basic (使用法)

Dim instance As BindingList(Of
 T)
Dim returnValue As T

returnValue = instance.AddNew

C#

public T AddNew ()

C++

public:
T AddNew ()

J#

public T AddNew ()

JScript

public function AddNew () : T

戻り値
リストに追加する項目。

例外

例外の種類	条件
InvalidOperationException	AllowNew プロパティが false に設定されています。 または 現在の項目の型に対応する既定のパブリック コンストラクタがありません。

解説

AddNew メソッドは、Items プロパティで表されるコレクションに新しい項目を追加します。新しい項目を追加するには、次のロジックを使用します。

1. AddingNew イベントが自動的に発生します。

   このイベントをプログラム上で処理することにより、新しいカスタム項目を作成できます。これは、イベント ハンドラで AddingNewEventArgs パラメータの NewObject プロパティを新しい項目に設定することによって実行できます。

   そうしない場合、新しい項目は、既定のパブリック コンストラクタを通じて自動的に作成されます。

2. 新しい項目の位置は追跡されますが、次の条件のいずれかが満たされるまでリストには追加されません。

   • 項目が、EndNew への呼び出しによって明示的にコミットされた。

   • 項目が、項目の挿入や削除など、リストの内容を変更するその他の操作によって暗黙的にコミットされた。

対照的に、項目がコミットされる前に CancelNew メソッドを呼び出すと、新しい項目は破棄されます。

新しい項目がコミットされると、このメソッドは ListChanged イベントを発生させます。

使用例

AddNew メソッドを使用する方法を次のコード例に示します。詳細については、BindingList クラスの概要のトピックを参照してくださいBindingList。

Visual Basic

' Add the new part unless the part number contains
' spaces. In that case cancel the add.
Private Sub button1_Click(ByVal
 sender As Object, _
    ByVal e As EventArgs) Handles
 button1.Click

    Dim newPart As Part = listOfParts.AddNew()

    If newPart.PartName.Contains(" ")
 Then
        MessageBox.Show("Part names cannot contain spaces.")
        listOfParts.CancelNew(listOfParts.IndexOf(newPart))
    Else
        textBox2.Text = randomNumber.Next(9999).ToString()
        textBox1.Text = "Enter part name"
    End If

End Sub

C#

// Add the new part unless the part number contains
// spaces. In that case cancel the add.
private void button1_Click(object sender, EventArgs
 e)
{
    Part newPart = listOfParts.AddNew();

    if (newPart.PartName.Contains(" "))
    {
        MessageBox.Show("Part names cannot contain spaces.");
        listOfParts.CancelNew(listOfParts.IndexOf(newPart));
    }
    else
    {
        textBox2.Text = randomNumber.Next(9999).ToString();
        textBox1.Text = "Enter part name";
    }
}

プラットフォーム

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

参照

関連項目
BindingList ジェネリック クラス
BindingList メンバ
System.ComponentModel 名前空間
IBindingList.AddNew
Activator.CreateInstance
Items
AddingNew
AllowNew
EndNew
CancelNew
RemoveItem
ListChanged