Aracılığıyla paylaş


ListViewInsertedEventArgs.KeepInInsertMode Özellik

Tanım

Kullanıcının giriş değerlerinin şablon içindeki InsertItemTemplate denetimler için korunup korunmadığını belirten bir değer alır veya ayarlar.

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

Özellik Değeri

true kullanıcının giriş değerleri şablon içindeki InsertItemTemplate denetimler için korunursa; false kullanıcının giriş değerleri denetimlerin varsayılan değerleriyle değiştirilirse. Varsayılan değer: false.

Örnekler

Aşağıdaki örnekte, ekleme işlemi sırasında bir hata oluştuğunda kullanıcı tarafından girilen değerleri korumak için özelliğinin nasıl kullanılacağı KeepInInsertMode gösterilmektedir. Bu kod örneği, sınıfı için ListViewInsertedEventArgs sağlanan daha büyük bir örneğin parçasıdır.

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

Açıklamalar

Varsayılan olarak, ListView denetim ekleme işleminden sonra denetimin InsertItemTemplate değerlerini şablondan varsayılan değerlerine sıfırlar. Bu, kullanıcıların eklenecek yeni bir öğe için değer eklemesine olanak tanır. Ekleme işlemi sırasında bir özel durum oluşursa, özelliğini trueolarak ayarlayarak KeepInInsertMode denetimi ekleme modunda tutabilirsinizListView. Bu, şablonun içindeki InsertItemTemplate denetimler için bir öğe eklemeye yönelik önceki denemedeki değerleri korur.

Şunlara uygulanır

Ayrıca bkz.