ListViewInsertedEventArgs.KeepInInsertMode Vlastnost

Definice

Obor názvů:

System.Web.UI.WebControls

Sestavení:

System.Web.Extensions.dll

Získá nebo nastaví hodnotu, která označ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í 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 při výskytu chyby 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 resetuje hodnoty ovládacího prvku ze InsertItemTemplate šablony na výchozí hodnoty po operaci vložení. 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 zachová hodnoty z předchozího pokusu o vložení položky pro ovládací prvky uvnitř InsertItemTemplate šablony.

Viz také

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