IEditableCollectionView.AddNew メソッド

定義

新しい項目をコレクションに追加します。Adds a new item to the collection.

public:
 System::Object ^ AddNew();
public object AddNew ();
abstract member AddNew : unit -> obj
Public Function AddNew () As Object

戻り値

コレクションに追加された新しい項目。The new item that is added to the collection.

次の例ではWindow 、新しい項目を追加するようにユーザーに求めるを作成します。The following example creates a Window that prompts the user to add a new item. 次に、 AddNewを呼び出して新しいオブジェクトを作成しDataContext 、のWindowをそのオブジェクトに設定します。Then it calls AddNew to create a new object and sets the DataContext of the Window to that object. サンプル全体については、「 IEditableCollectionView サンプルを使用したコレクションの変更」を参照してください。For the entire sample, see Changing a Collection by Using IEditableCollectionView Sample.

IEditableCollectionView editableCollectionView = 
    itemsControl.Items as IEditableCollectionView; 

if (!editableCollectionView.CanAddNew)
{
    MessageBox.Show("You cannot add items to the list.");
    return;
}

// Create a window that prompts the user to enter a new
// item to sell.
ChangeItemWindow win = new ChangeItemWindow();

//Create a new item to be added to the collection.
win.DataContext = editableCollectionView.AddNew();

// If the user submits the new item, commit the new
// object to the collection.  If the user cancels 
// adding the new item, discard the new item.
if ((bool)win.ShowDialog())
{
    editableCollectionView.CommitNew();
}
else
{
    editableCollectionView.CancelNew();
}

Dim editableCollectionView As IEditableCollectionView = TryCast(itemsControl.Items, IEditableCollectionView)

If Not editableCollectionView.CanAddNew Then
    MessageBox.Show("You cannot add items to the list.")
    Return
End If

' Create a window that prompts the user to enter a new
' item to sell.
Dim win As New ChangeItemWindow()

'Create a new item to be added to the collection.
win.DataContext = editableCollectionView.AddNew()

' If the user submits the new item, commit the new
' object to the collection.  If the user cancels 
' adding the new item, discard the new item.
If CBool(win.ShowDialog()) Then
    editableCollectionView.CommitNew()
Else
    editableCollectionView.CancelNew()
End If

注釈

AddNew呼び出すと、add トランザクションが開始されます。Calling AddNew begins an add transaction. Add トランザクションをCommitNew終了CancelNewするには、またはを呼び出す必要があります。You should call CommitNew or CancelNew to end the add transaction. コレクションビューには、常に新しい項目が表示されます。A new item always appears in the collection view. が呼び出されるとCommitNew 、ビューに適用されているすべてのフィルター処理、並べ替え、またはグループ化が新しい項目に適用されます。Any filtering, sorting, or grouping that is applied to the view is applied to the new item when CommitNew is called.

適用対象