Sdílet prostřednictvím

ListViewInsertedEventArgs.AffectedRows Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.Extensions.dll

Získá počet řádků ovlivněné operací vložení.

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

Hodnota vlastnosti

Int32

Počet řádků ovlivněných operací vložení

Příklady

Následující příklad ukazuje, jak použít ListViewInsertedEventArgs objekt, který je předán obslužné rutině ItemInserted pro událost k určení, zda byla během operace vložení vyvolána výjimka. Tento příklad kódu je součástí většího příkladu ListViewInsertedEventArgs pro třídu .

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

Poznámky

AffectedRows Pomocí vlastnosti určete počet záznamů, které byly ovlivněny operací vložení, jak je vrátil ovládací prvek zdroje dat. Tato vlastnost se obvykle používá v následujících scénářích:

  • Chcete-li ověřit, že byl vložen pouze jeden záznam. Někdy může nesprávně napsaný příkaz insert vložit více záznamů.

  • Ověření, že záznam nebyl vložen, protože během operace vložení došlo k chybě, ale nebyla vyvolána výjimka.

  • Ověření, že záznam byl vložen, když ovládací prvek zdroje dat, který podporuje detekci konfliktů (optimistická souběžnost), má vlastnost ConflictDetection nastavenou na hodnotu výčtu ConflictOptions.CompareAllValues . Mezi ovládací prvky, které tuto vlastnost podporují, SqlDataSource patří ovládací prvky a ObjectDataSource . Pokud má vlastnost tuto hodnotu, záznam nemusí být vložen, pokud má stejnou hodnotu klíče jako záznam vložený jiným uživatelem.

Platí pro

Viz také