IEditableCollectionView.AddNew Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přidá do kolekce novou položku.
public:
System::Object ^ AddNew();
public object AddNew();
abstract member AddNew : unit -> obj
Public Function AddNew () As Object
Návraty
Nová položka přidaná do kolekce.
Příklady
Následující příklad vytvoří výzvu Window k přidání nové položky uživatele. Potom volá AddNew vytvoření nového objektu a nastaví DataContextWindow objekt na tento objekt. Pro celou ukázku viz Změna kolekce pomocí IEditableCollectionView Sample.
IEditableCollectionView editableCollectionView =
itemsControl.Items;
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()
{
//Create a new item to be added to the collection.
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
Poznámky
Volání AddNew zahájí přidání transakce. Měli byste zavolat CommitNew nebo CancelNew ukončit transakci přidání. Nová položka se vždy zobrazí v zobrazení kolekce. Všechny filtrování, řazení nebo seskupení použité v zobrazení se použijí na novou položku, pokud CommitNew je volána.