Condividi tramite

ListViewInsertedEventArgs.AffectedRows Proprietà

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.Extensions.dll

Ottiene il numero di righe interessate dall'operazione di inserimento.

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

Valore della proprietà

Int32

Numero di righe interessate dall'operazione di inserimento.

Esempio

Nell'esempio seguente viene illustrato come utilizzare l'oggetto ListViewInsertedEventArgs passato a un gestore per l'evento ItemInserted per determinare se è stata generata un'eccezione durante l'operazione di inserimento. Questo esempio di codice fa parte di un esempio più ampio fornito per la ListViewInsertedEventArgs classe .

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

Commenti

Utilizzare la AffectedRows proprietà per determinare il numero di record interessati dall'operazione di inserimento, come restituito dal controllo origine dati. Questa proprietà viene in genere usata negli scenari seguenti:

  • Per verificare che sia stato inserito solo un singolo record. In alcuni casi un'istruzione insert scritta in modo non corretto può inserire più record.

  • Per verificare che un record non sia stato inserito perché si è verificato un errore durante l'operazione di inserimento, ma non è stata generata un'eccezione.

  • Per verificare che un record sia stato inserito quando un controllo origine dati che supporta il rilevamento dei conflitti (concorrenza ottimistica) ha la proprietà ConflictDetection impostata sul ConflictOptions.CompareAllValues valore di enumerazione. I controlli che supportano questa proprietà includono i SqlDataSource controlli e ObjectDataSource . Quando la proprietà ha questo valore, un record potrebbe non essere inserito se ha lo stesso valore di chiave di un record inserito da un altro utente.

Si applica a

Vedi anche