Udostępnij za pośrednictwem

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żyć obiektu przekazanego ListViewInsertedEventArgs do procedury obsługi dla ItemInserted zdarzenia w celu określenia, czy podczas operacji wstawiania został zgłoszony wyjątek. Ten przykład kodu jest częścią większego przykładu udostępnionego 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

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

  • Aby sprawdzić, czy został wstawiony 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 kontrolka źródła danych, która obsługuje wykrywanie konfliktów (optymistyczna współbieżność), ma właściwość ConflictDetection ustawioną na ConflictOptions.CompareAllValues 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 tę samą wartość klucza co rekord wstawiony przez innego użytkownika.

Dotyczy

Zobacz też