ListViewInsertedEventArgs.AffectedRows Özellik

Tanım

Ad Alanı:

System.Web.UI.WebControls

Bütünleştirilmiş Kod:

System.Web.Extensions.dll

Ekleme işleminden etkilenen satır sayısını alır.

public:
 property int AffectedRows { int get(); };

public int AffectedRows { get; }

member this.AffectedRows : int

Public ReadOnly Property AffectedRows As Integer

Özellik Değeri

Int32

Ekleme işleminden etkilenen satır sayısı.

Örnekler

Aşağıdaki örnekte, ekleme işlemi sırasında bir özel durumun tetiklenip tetiklenmediğini belirlemek için olay işleyicisine ItemInserted geçirilen nesnenin nasıl kullanılacağı ListViewInsertedEventArgs 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

AffectedRows Veri kaynağı denetimi tarafından döndürülen ekleme işleminden etkilenen kayıt sayısını belirlemek için özelliğini kullanın. Bu özellik genellikle aşağıdaki senaryolarda kullanılır:

• Yalnızca tek bir kaydın eklendiğini doğrulamak için. Bazen yanlış yazılmış bir insert deyimi birden çok kayıt ekleyebilir.

• Ekleme işlemi sırasında bir hata oluştuğundan, ancak bir özel durum oluşmadığından kaydın eklenmediğini doğrulamak için.

• Çakışma algılamayı (iyimser eşzamanlılık) ConflictDetection destekleyen bir veri kaynağı denetiminin özelliği numaralandırma değerine ayarlandığında kaydın ConflictOptions.CompareAllValues eklendiğini doğrulamak için. Bu özelliği destekleyen denetimler ve ObjectDataSource denetimlerini SqlDataSource içerir. özelliği bu değere sahip olduğunda, başka bir kullanıcı tarafından eklenen kayıtla aynı anahtar değerine sahipse bir kayıt eklenmeyebilir.

Ayrıca bkz.

• ListView
• ItemInserted
• Exception
• ExceptionHandled
• Values
• Teknolojiye Genel Bakış: ListView Denetimi