ListViewInsertedEventArgs.AffectedRows Egenskap

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

public int AffectedRows { get; }

member this.AffectedRows : int

Public ReadOnly Property AffectedRows As Integer

Egenskapsvärde

Antalet rader som påverkas av infogningsåtgärden.

Exempel

I följande exempel visas hur du använder objektet ListViewInsertedEventArgs som skickas till en hanterare för händelsen för ItemInserted att avgöra om ett undantag uppstod under infogningsåtgärden. Det här kodexemplet är en del av ett större exempel för ListViewInsertedEventArgs klassen.

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

Kommentarer

AffectedRows Använd egenskapen för att fastställa antalet poster som påverkades av infogningsåtgärden, vilket returnerades av datakällans kontroll. Den här egenskapen används vanligtvis i följande scenarier:

• Kontrollera att endast en enskild post har infogats. Ibland kan en felaktigt skriven infogningsinstrukation infoga flera poster.

• Kontrollera att en post inte infogades eftersom ett fel uppstod under infogningsåtgärden, men ett undantag uppstod inte.

• För att verifiera att en post infogades när en datakällakontroll som stöder konfliktidentifiering (optimistisk samtidighet) har dess ConflictDetection egenskap inställd på ConflictOptions.CompareAllValues uppräkningsvärdet. Kontroller som stöder den här egenskapen innehåller SqlDataSource kontrollerna och ObjectDataSource . När egenskapen har det här värdet kanske en post inte infogas om den har samma nyckelvärde som en post som infogats av en annan användare.

Se även

• ListView
• ItemInserted
• Exception
• ExceptionHandled
• Values
• Tekniköversikt: ListView-kontrollen