Questa pagina è stata utile?
I suggerimenti relativi al contenuto di questa pagina sono importanti. Comunicaceli.
Altri suggerimenti?
1500 caratteri rimanenti
Esporta (0) Stampa
Espandi tutto

Metodo SqlDataSourceView.ExecuteUpdate

Nota: questo metodo è stato introdotto con .NET Framework versione 2.0.

Esegue un'operazione di aggiornamento utilizzando la stringa SQL UpdateCommand tutti i parametri presenti 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
)
protected int ExecuteUpdate (
	IDictionary keys, 
	IDictionary values, 
	IDictionary oldValues
)
protected override function ExecuteUpdate (
	keys : IDictionary, 
	values : IDictionary, 
	oldValues : IDictionary
) : int

Parametri

keys

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 riferimento null (Nothing in Visual Basic).

values

Insieme IDictionary di valori da utilizzare con la proprietà UpdateCommand per eseguire l'operazione di aggiornamento del database. Se non sono presenti parametri associati con la query oppure se la proprietà UpdateCommand non dispone di query SQL con parametri, viene passato riferimento null (Nothing in Visual Basic).

oldValues

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 riferimento null (Nothing in Visual Basic).

Valore restituito

Valore che rappresenta il numero di righe aggiornate nel database sottostante.

Tipo di 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 genera 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.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supportato in: 2.0

Aggiunte alla community

AGGIUNGI
Mostra:
© 2015 Microsoft