ListViewInsertedEventArgs.AffectedRows Proprietà

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

public int AffectedRows { get; }

member this.AffectedRows : int

Public ReadOnly Property AffectedRows As Integer

Valore della proprietà

Il numero di righe interessate dall'operazione di inserimento.

Esempio

Nell'esempio seguente viene illustrato come usare l'oggetto ListViewInsertedEventArgs passato a un gestore per l'evento per determinare se è stata generata un'eccezione durante l'operazione ItemInserted di inserimento. Questo esempio di codice fa parte di un esempio più grande 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. A volte un'istruzione di inserimento scritta in modo errato 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 relativa ConflictDetection proprietà 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

• ListView
• ItemInserted
• Exception
• ExceptionHandled
• Values
• Panoramica della tecnologia: controllo ListView