ListViewInsertedEventArgs.KeepInInsertMode Vlastnost

Definice

Obor názvů:

System.Web.UI.WebControls

Sestavení:

System.Web.Extensions.dll

Získá nebo nastaví hodnotu, která určuje, zda jsou vstupní hodnoty uživatele zachovány 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 jsou vstupní hodnoty uživatele zachovány 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í hodnota je false.

Příklady

Následující příklad ukazuje, jak pomocí KeepInInsertMode vlastnosti zachovat hodnoty zadané uživatelem, když dojde k chybě během operace vložení. Tento příklad kódu je součástí většího příkladu uvedeného pro třídu ListViewInsertedEventArgs.

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 obnoví hodnoty ovládacího prvku ze InsertItemTemplate šablony na výchozí hodnoty po operaci vložení. To umožňuje uživatelům přidávat hodnoty pro vložení nové položky. Pokud je během operace vložení vyvolána výjimka, můžete ovládací prvek zachovat ListView v režimu vložení nastavením KeepInInsertMode vlastnosti na truehodnotu . Tím se zachová hodnoty z předchozího pokusu o vložení položky ovládacích prvků uvnitř InsertItemTemplate šablony.

Viz také

• ListView
• Přehled technologií: Ovládací prvek ListView