ListViewInsertedEventArgs.AffectedRows Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.Extensions.dll

Pobiera liczbę wierszy, których dotyczy operacja wstawiania.

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

Wartość właściwości

Int32

Liczba wierszy, których dotyczy operacja wstawiania.

Przykłady

W poniższym przykładzie pokazano, jak używać obiektu przekazanego ListViewInsertedEventArgs do procedury obsługi dla ItemInserted zdarzenia w celu określenia, czy wyjątek został zgłoszony podczas operacji wstawiania. Ten przykład kodu jest częścią większego przykładu podanego ListViewInsertedEventArgs dla klasy.

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

Uwagi

Użyj właściwości , AffectedRows aby określić liczbę rekordów, których dotyczy operacja wstawiania, zwrócona przez kontrolę źródła danych. Ta właściwość jest zwykle używana w następujących scenariuszach:

  • Aby sprawdzić, czy wstawiono tylko jeden rekord. Czasami niepoprawnie napisana instrukcja insert może wstawić wiele rekordów.

  • Aby sprawdzić, czy rekord nie został wstawiony, ponieważ wystąpił błąd podczas operacji wstawiania, ale nie został zgłoszony wyjątek.

  • Aby sprawdzić, czy rekord został wstawiony, gdy kontrola źródła danych, która obsługuje wykrywanie konfliktów (optymistyczna współbieżność) ma właściwość ConflictDetection ustawioną ConflictOptions.CompareAllValues na wartość wyliczenia. Kontrolki obsługujące tę właściwość obejmują kontrolki SqlDataSource i ObjectDataSource . Jeśli właściwość ma tę wartość, rekord może nie zostać wstawiony, jeśli ma taką samą wartość klucza, jak rekord wstawiony przez innego użytkownika.

Dotyczy

Zobacz też