SqlDataSourceView.ExecuteDelete(IDictionary, IDictionary) Metodo

  • Riferimento

Definizione

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

Esegue un'operazione di eliminazione utilizzando la stringa SQL DeleteCommand, tutti i parametri specificati nell'insieme DeleteParameters e i valori contenuti negli insiemi keys e oldValues specificati.

protected:
 override int ExecuteDelete(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ oldValues);
protected override int ExecuteDelete (System.Collections.IDictionary keys, System.Collections.IDictionary oldValues);
override this.ExecuteDelete : System.Collections.IDictionary * System.Collections.IDictionary -> int
Protected Overrides Function ExecuteDelete (keys As IDictionary, oldValues As IDictionary) As Integer

Parametri

keys
IDictionary

Interfaccia IDictionary di oggetti o di valori di riga chiave per l'operazione ExecuteDelete(IDictionary, IDictionary) da eliminare.

oldValues
IDictionary

Interfaccia IDictionary che contiene valori di riga che vengono valutati soltanto se la proprietà ConflictDetection è impostata sul valore CompareAllValues.

Restituisce

Int32

Valore che rappresenta il numero di righe eliminate dal database sottostante.

Eccezioni

InvalidOperationException

L'oggetto SqlDataSource non può stabilire una connessione con l'origine dati sottostante.

-oppure-

La proprietà ConflictDetection è impostata sul valore CompareAllValues e non viene passato alcun parametro oldValues.

HttpException

L'utente corrente non dispone delle autorizzazioni corrette per accedere al database.

-oppure-

L'istanza del controllo è un controllo AccessDataSource e viene negato l'accesso al percorso specificato per la proprietà DataFile.

NotSupportedException

La proprietà CanDelete è false.

-oppure-

Nella finestra di progettazione non è stato eseguito in modo corretto il mapping di un percorso relativo alla fase di progettazione prima di utilizzare un'istanza del controllo AccessDataSource.

Commenti

La SqlDataSourceView classe implementa il metodo ereditato ExecuteDelete per eliminare i dati da un database. Gli sviluppatori di pagine e gli autori di controlli associati a dati non chiamano direttamente il ExecuteDelete metodo, ma usano invece il metodo esposto Delete pubblicamente.

I valori contenuti nell'insieme keys vengono valutati e uniti a tutti i valori contenuti nell'insieme DeleteParameters . Se la ConflictDetection proprietà è impostata sul CompareAllValues valore , i valori contenuti nell'insieme oldValues vengono formattati con la OldValuesParameterFormatString proprietà e vengono uniti.

Prima di eseguire l'operazione di eliminazione, viene chiamato il OnDeleting metodo per generare l'evento Deleting . È possibile gestire questo evento per esaminare i valori dei parametri e per eseguire qualsiasi pre-elaborazione prima di un'eliminazione.

Per eseguire un'operazione di eliminazione, l'oggetto SqlDataSourceView compila un DbCommand oggetto usando il DeleteCommand testo e le proprietà associate DeleteParameters e quindi esegue l'oggetto DbCommand sul database sottostante. Al termine dell'operazione di eliminazione, viene chiamato il OnDeleted metodo per generare l'evento Deleted . È possibile gestire questo evento per esaminare i valori restituiti e i codici di errore e per eseguire qualsiasi post-elaborazione.

Si applica a

Vedi anche