SqlDataSourceView.ExecuteDelete(IDictionary, IDictionary) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> intProtected Overrides Function ExecuteDelete (keys As IDictionary, oldValues As IDictionary) As IntegerParametri
- 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
Valore che rappresenta il numero di righe eliminate dal database sottostante.
Eccezioni
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.
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.
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.
