Esporta (0) Stampa
Espandi tutto
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale

Metodo SqlDataSourceView.ExecuteUpdate

Esegue un'operazione di aggiornamento utilizzando la stringa SQL UpdateCommand tutti i parametri specificati nell'insieme UpdateParameters e i valori degli insiemi keys, values e oldValues specificati.

Spazio dei nomi:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

protected override int ExecuteUpdate(
	IDictionary keys,
	IDictionary values,
	IDictionary oldValues
)

Parametri

keys
Tipo: System.Collections.IDictionary
Insieme IDictionary di chiavi primarie da utilizzare con la proprietà UpdateCommand per eseguire l'operazione di aggiornamento del database. Se non sono presenti chiavi associate alla query oppure se la proprietà UpdateCommand non dispone di query SQL con parametri, viene passato null.
values
Tipo: System.Collections.IDictionary
Insieme IDictionary di valori da utilizzare con la proprietà UpdateCommand per eseguire l'operazione di aggiornamento del database. Se non sono presenti parametri associati alla query oppure se la proprietà UpdateCommand non dispone di query SQL con parametri, viene passato null.
oldValues
Tipo: System.Collections.IDictionary
Insieme IDictionary che rappresenta i valori originali nel database. Se non sono presenti parametri associati alla query oppure se la proprietà UpdateCommand non dispone di query SQL con parametri, viene passato null.

Valore restituito

Tipo: System.Int32
Valore che rappresenta il numero di righe aggiornate nel database sottostante.

EccezioneCondizione
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 ottenere l'accesso al database.

NotSupportedException

La proprietà CanUpdate è false.

La classe SqlDataSourceView implementa il metodo ExecuteUpdate ereditato per aggiornare dati in un database. Gli sviluppatori di pagine e gli autori di controlli con associazione a dati non chiamano direttamente il metodo ExecuteUpdate, ma utilizzano il metodo Update esposto pubblicamente.

I valori contenuti negli insiemi keys e values sono valutati e uniti ai valori contenuti nell'insieme UpdateParameters. Se la proprietà ConflictDetection è impostata su CompareAllValues, i valori contenuti nell'insieme oldValues vengono formattati con la proprietà OldValuesParameterFormatString, nonché uniti.

Prima di eseguire l'operazione di aggiornamento, viene chiamato il metodo OnUpdating per generare l'evento Updating. È possibile gestire questo evento per esaminare i valori dei parametri ed eseguire qualsiasi operazione di pre-elaborazione prima di un aggiornamento.

Per eseguire l'operazione, l'oggetto SqlDataSourceView compila un oggetto DbCommand utilizzando il testo UpdateCommand e tutte le proprietà UpdateParameters associate; quindi esegue l'oggetto DbCommand nel database sottostante. Dopo il completamento dell'operazione, viene chiamato il metodo OnUpdated per generare l'evento Updated. È possibile gestire questo evento per esaminare tutti i valori restituiti insieme ai codici di errore e per eseguire la post-elaborazione.

.NET Framework

Supportato in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft