Sdílet prostřednictvím

ListViewInsertedEventArgs.AffectedRows Vlastnost

Definice

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

Získá počet řádků ovlivněných 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 události k určení, zda byla vyvolána výjimka během operace vložení. Tento příklad kódu je součástí většího příkladu uvedeného pro třídu ListViewInsertedEventArgs.

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 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ů.

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

  • Chcete-li ověřit, že záznam byl vložen, když má ovládací prvek zdroje dat podporující detekci konfliktů (optimistická souběžnost) jeho ConflictDetection vlastnost nastavena na hodnotu výčtu ConflictOptions.CompareAllValues . Ovládací prvky, které tuto vlastnost podporují, zahrnují ovládací SqlDataSource prvky a ObjectDataSource ovládací prvky. Pokud vlastnost má 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é