Nyelv

ListViewInsertedEventArgs.AffectedRows Tulajdonság

Definíció

Névtér:
System.Web.UI.WebControls
Szerelvény:
System.Web.Extensions.dll

A beszúrási művelet által érintett sorok számát adja meg.

public:
 property int AffectedRows { int get(); };
public int AffectedRows { get; }
member this.AffectedRows : int
Public ReadOnly Property AffectedRows As Integer

Tulajdonság értéke

Int32

A beszúrási művelet által érintett sorok száma.

Példák

Az alábbi példa bemutatja, hogyan használhatja az ListViewInsertedEventArgs esemény kezelőjének átadott objektumot annak megállapítására ItemInserted , hogy kivétel történt-e a beszúrási művelet során. Ez a példakód egy nagyobb, az ListViewInsertedEventArgs osztályhoz tartozó példa része.

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

Megjegyzések

AffectedRows A tulajdonság segítségével meghatározhatja a beszúrási művelet által érintett rekordok számát az adatforrás-vezérlő által visszaadott módon. Ezt a tulajdonságot általában a következő helyzetekben használják:

  • Annak ellenőrzéséhez, hogy csak egyetlen rekord lett-e beszúrva. Néha egy helytelenül írt beszúrási utasítás több rekordot is beszúrhat.

  • Annak ellenőrzéséhez, hogy egy rekord nem lett-e beszúrva, mert hiba történt a beszúrási művelet során, de nem történt kivétel.

  • Annak ellenőrzéséhez, hogy egy rekord akkor lett-e beszúrva, ha egy ütközésészlelést támogató adatforrás-vezérlő (optimista egyidejűség) tulajdonsága ConflictDetection az ConflictOptions.CompareAllValues enumerálási értékre van állítva. A tulajdonságot támogató vezérlők közé tartoznak a vezérlők és SqlDataSource a ObjectDataSource vezérlők. Ha a tulajdonság rendelkezik ezzel az értékkel, előfordulhat, hogy egy rekord nem lesz beszúrva, ha ugyanazzal a kulcsértékel rendelkezik, mint egy másik felhasználó által beszúrt rekord.

A következőre érvényes:

Lásd még