Sdílet prostřednictvím

ListViewInsertedEventArgs.KeepInInsertMode Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.Extensions.dll

Získá nebo nastaví hodnotu, která označuje, zda jsou zachovány vstupní hodnoty uživatele pro ovládací prvky uvnitř InsertItemTemplate šablony.

public:
 property bool KeepInInsertMode { bool get(); void set(bool value); };
public bool KeepInInsertMode { get; set; }
member this.KeepInInsertMode : bool with get, set
Public Property KeepInInsertMode As Boolean

Hodnota vlastnosti

Boolean

true pokud se zachovají vstupní hodnoty uživatele pro ovládací prvky uvnitř InsertItemTemplate šablony; false pokud jsou vstupní hodnoty uživatele nahrazeny výchozími hodnotami ovládacích prvků. Výchozí formát je false.

Příklady

Následující příklad ukazuje, jak použít KeepInInsertMode vlastnost k zachování hodnot zadaných uživatelem, když dojde k chybě během operace vložení. Tento příklad kódu je součástí většího příkladu ListViewInsertedEventArgs pro třídu .

void ContactsListView_ItemInserted(Object sender, ListViewInsertedEventArgs e)
{
  if (e.Exception != null)
  {
    if (e.AffectedRows == 0)
    {
      e.KeepInInsertMode = true;
      Message.Text = "An exception occurred inserting the new Contact. " +
        "Please verify your values and try again.";
    }
    else
      Message.Text = "An exception occurred inserting the new Contact. " +
        "Please verify the values in the newly inserted item.";

    e.ExceptionHandled = true;
  }
}

Sub ContactsListView_ItemInserted(ByVal sender As Object, ByVal e As ListViewInsertedEventArgs)

  If e.Exception IsNot Nothing Then

    If e.AffectedRows = 0 Then
      e.KeepInInsertMode = True
      Message.Text = "An exception occurred inserting the new Contact. " & _
        "Please verify your values and try again."
    Else
      Message.Text = "An exception occurred inserting the new Contact. " & _
        "Please verify the values in the newly inserted item."
    End If

    e.ExceptionHandled = True
  End If
End Sub

Poznámky

Ve výchozím nastavení ListView ovládací prvek po operaci vložení obnoví hodnoty ovládacího prvku ze InsertItemTemplate šablony na výchozí hodnoty. To umožňuje uživatelům přidat hodnoty pro novou položku, která má být vložena. Pokud během operace vložení dojde k výjimce, můžete ovládací prvek ponechat ListView v režimu vložení nastavením KeepInInsertMode vlastnosti na truehodnotu . Tím se zachovají hodnoty z předchozího pokusu o vložení položky pro ovládací prvky uvnitř InsertItemTemplate šablony.

Platí pro

Viz také