Classe SqlDataSource (System.Web.UI.WebControls)

Cambia visualizzazione:
Classica
Lightweight
ScriptFree
Riferimento a .NET Framework
Classe SqlDataSource
Il presente articolo è stato tradotto manualmente. Per visualizzare questa pagina e contemporaneamente visualizzarne il contenuto in lingua inglese, passare alla visualizzazione semplificata.

Rappresenta un database di SQL nei controlli con associazione a dati.

Gerarchia di ereditarietà
System.Object
  System.Web.UI.Control
    System.Web.UI.DataSourceControl
      System.Web.UI.WebControls.SqlDataSource
        System.Web.UI.WebControls.AccessDataSource

Spazio dei nomi:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)
Sintassi
Visual Basic
<ToolboxBitmapAttribute(GetType(SqlDataSource))> _
Public Class SqlDataSource _
	Inherits DataSourceControl
C#
[ToolboxBitmapAttribute(typeof(SqlDataSource))]
public class SqlDataSource : DataSourceControl
Visual C++
[ToolboxBitmapAttribute(typeof(SqlDataSource))]
public ref class SqlDataSource : public DataSourceControl
F#
[<ToolboxBitmapAttribute(typeof(SqlDataSource))>]
type SqlDataSource =  
    class
        inherit DataSourceControl
    end
ASP.NET
<asp:SqlDataSource />

Il tipo SqlDataSource espone i seguenti membri.

Costruttori
  Nome Descrizione
Metodo pubblico SqlDataSource() Inizializza una nuova istanza della classe SqlDataSource.
Metodo pubblico SqlDataSource(String, String) Inizializza una nuova istanza della classe SqlDataSource con la stringa di connessione specificata e il comando Seleziona.
Metodo pubblico SqlDataSource(String, String, String) Inizializza una nuova istanza della classe SqlDataSource con la stringa di connessione specificata e il comando Seleziona.
In alto
Proprietà
  Nome Descrizione
Proprietà protetta. Adapter Ottiene l'adattatore specifico del browser per il controllo. (Ereditato da Control)
Proprietà pubblica AppRelativeTemplateSourceDirectory Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl contenente questo controllo. (Ereditato da Control)
Proprietà pubblica BindingContainer Infrastruttura. Ottiene il controllo contenente l'associazione dati del controllo corrente. (Ereditato da Control)
Proprietà pubblica CacheDuration Ottiene o imposta il numero di secondi durante i quali il controllo origine dati memorizza nella cache i dati recuperati dal metodo Select.
Proprietà pubblica CacheExpirationPolicy Ottiene o imposta il comportamento di scadenza della cache che, quando combinato con la durata, descrive il comportamento della cache utilizzato dal controllo origine dati.
Proprietà pubblica CacheKeyDependency Ottiene o imposta una dipendenza di chiave definita dall'utente collegata a tutti gli oggetti cache dati creati dal controllo origine dati. Tutti gli oggetti relativi alla cache scadono in modo esplicito quando scade la chiave.
Proprietà pubblica CancelSelectOnNullParameter Ottiene o imposta un valore indicante se un'operazione di recupero dati viene annullata quando qualsiasi parametro contenuto nell'insieme SelectParameters restituisce null.
Proprietà protetta. ChildControlsCreated Ottiene un valore che indica se i controlli figli del controllo server sono stati creati. (Ereditato da Control)
Proprietà pubblica ClientID Ottiene l'identificatore del controllo server generato da ASP.NET. (Ereditato da DataSourceControl)
Proprietà pubblica ClientIDMode Questa proprietà non viene utilizzata per i controlli origine dati. (Ereditato da DataSourceControl)
Proprietà protetta. ClientIDSeparator Ottiene un carattere che rappresenta il separatore utilizzato nella proprietà ClientID. (Ereditato da Control)
Proprietà pubblica ConflictDetection Ottiene o imposta il valore indicante come il controllo SqlDataSource esegue aggiornamenti ed eliminazioni quando i dati in una riga del database sottostante vengono modificati durante l'operazione.
Proprietà pubblica ConnectionString Ottiene o imposta la stringa di connessione specifica del provider ADO.NET utilizzata dal controllo SqlDataSource per la connessione a un database sottostante.
Proprietà protetta. Context Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente. (Ereditato da Control)
Proprietà pubblica Controls Ottiene un oggetto ControlCollection che rappresenta i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente. (Ereditato da DataSourceControl)
Proprietà pubblica DataItemContainer Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer. (Ereditato da Control)
Proprietà pubblica DataKeysContainer Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl. (Ereditato da Control)
Proprietà pubblica DataSourceMode Ottiene o imposta la modalità di recupero dati utilizzata dal controllo SqlDataSource per recuperare dati.
Proprietà pubblica DeleteCommand Ottiene o imposta la stringa SQL utilizzata dal controllo SqlDataSource per eliminare dati dal database sottostante.
Proprietà pubblica DeleteCommandType Ottiene o imposta un valore indicante se il testo nella proprietà DeleteCommand è un'istruzione SQL o il nome di una stored procedure.
Proprietà pubblica DeleteParameters Ottiene l'insieme di parametri che contiene i parametri utilizzati dalla proprietà DeleteCommand dall'oggetto SqlDataSourceView associato al controllo SqlDataSource.
Proprietà protetta. DesignMode Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione. (Ereditato da Control)
Proprietà pubblica EnableCaching Ottiene o imposta un valore indicante se la memorizzazione di dati nella cache è abilitata nel controllo SqlDataSource.
Proprietà pubblica EnableTheming Ottiene un valore che indica se il controllo supporta i temi. (Ereditato da DataSourceControl)
Proprietà pubblica EnableViewState Ottiene o imposta un valore che indica se il controllo server conserva il proprio stato di visualizzazione e lo stato di visualizzazione dei controlli figlio in esso contenuti per il client richiedente. (Ereditato da Control)
Proprietà protetta. Events Ottiene un elenco dei delegati del gestore eventi per il controllo. Questa proprietà è in sola lettura. (Ereditato da Control)
Proprietà pubblica FilterExpression Ottiene o imposta un'espressione di filtro applicata quando viene chiamato il metodo Select.
Proprietà pubblica FilterParameters Ottiene un insieme di parametri associati a tutti i segnaposto di parametro nella stringa FilterExpression.
Proprietà protetta. HasChildViewState Ottiene un valore che indica se per i controlli figlio del controllo server corrente esistono impostazioni dello stato di visualizzazione salvate. (Ereditato da Control)
Proprietà pubblica ID Ottiene o imposta l'identificatore a livello di codice assegnato al controllo server. (Ereditato da Control)
Proprietà protetta. IdSeparator Infrastruttura. Ottiene il carattere utilizzato per separare gli identificatori di controllo. (Ereditato da Control)
Proprietà pubblica InsertCommand Ottiene o imposta la stringa SQL utilizzata dal controllo SqlDataSource per inserire dati nel database sottostante.
Proprietà pubblica InsertCommandType Ottiene o imposta un valore indicante se il testo nella proprietà InsertCommand è un'istruzione SQL o il nome di una stored procedure.
Proprietà pubblica InsertParameters Ottiene l'insieme di parametri che contiene i parametri utilizzati dalla proprietà InsertCommand dall'oggetto SqlDataSourceView associato al controllo SqlDataSource.
Proprietà protetta. IsChildControlStateCleared Ottiene un valore che indica se i controlli contenuti in questo controllo dispongono di informazioni sullo stato del controllo. (Ereditato da Control)
Proprietà protetta. IsTrackingViewState Ottiene un valore che indica se il controllo server salva le modifiche allo stato di visualizzazione. (Ereditato da Control)
Proprietà protetta. IsViewStateEnabled Ottiene un valore che indica se lo stato di visualizzazione è attivato per il controllo corrente. (Ereditato da Control)
Proprietà protetta. LoadViewStateByID Ottiene un valore che indica se il controllo prende parte al caricamento del proprio stato di visualizzazione tramite ID anziché tramite l'indice. (Ereditato da Control)
Proprietà pubblica NamingContainer Ottiene un riferimento al contenitore dei nomi del controllo server, che crea uno spazio dei nomi univoco per distinguere i controlli server che hanno lo stesso valore della proprietà Control.ID. (Ereditato da Control)
Proprietà pubblica OldValuesParameterFormatString Ottiene o imposta una stringa di formato da applicare ai nomi di tutti i parametri passati al metodo Delete o Update.
Proprietà pubblica Page Ottiene un riferimento all'istanza Page che contiene il controllo server. (Ereditato da Control)
Proprietà pubblica Parent Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli della pagina. (Ereditato da Control)
Proprietà pubblica ProviderName Ottiene o imposta il nome del provider di dati .NET Framework utilizzato dal controllo SqlDataSource per la connessione a un'origine dati sottostante.
Proprietà pubblica RenderingCompatibility Ottiene un valore che specifica la versione di ASP.NET con cui sarà compatibile il codice HTML di cui è stato eseguito il rendering. (Ereditato da Control)
Proprietà pubblica SelectCommand Ottiene o imposta la stringa SQL utilizzata dal controllo SqlDataSource per recuperare dati dal database sottostante.
Proprietà pubblica SelectCommandType Ottiene o imposta un valore indicante se il testo nella proprietà SelectCommand è una query SQL o il nome di una stored procedure.
Proprietà pubblica SelectParameters Ottiene l'insieme di parametri che contiene i parametri utilizzati dalla proprietà SelectCommand dall'oggetto SqlDataSourceView associato al controllo SqlDataSource.
Proprietà pubblica Site Ottiene informazioni sul contenitore del controllo corrente quando viene eseguito il rendering in un'area di progettazione. (Ereditato da Control)
Proprietà pubblica SkinID Ottiene l'interfaccia da applicare al controllo DataSourceControl. (Ereditato da DataSourceControl)
Proprietà pubblica SortParameterName Ottiene o imposta il nome di un parametro di stored procedure utilizzato per ordinare i dati recuperati quando il recupero dati viene eseguito utilizzando una stored procedure.
Proprietà pubblica SqlCacheDependency Ottiene o imposta una stringa delimitata da punti e virgola che indica i database e le tabelle da utilizzare per la dipendenza della cache da Microsoft SQL Server.
Proprietà pubblica TemplateControl Ottiene o imposta un riferimento al modello che contiene il controllo. (Ereditato da Control)
Proprietà pubblica TemplateSourceDirectory Ottiene la directory virtuale dell'oggetto Page o dell'oggetto UserControl che contiene il controllo server corrente. (Ereditato da Control)
Proprietà pubblica UniqueID Ottiene l'identificatore univoco qualificato gerarchicamente per il controllo server. (Ereditato da Control)
Proprietà pubblica UpdateCommand Ottiene o imposta la stringa SQL utilizzata dal controllo SqlDataSource per aggiornare i dati nel database sottostante.
Proprietà pubblica UpdateCommandType Ottiene o imposta un valore indicante se il testo nella proprietà UpdateCommand è un'istruzione SQL o il nome di una stored procedure.
Proprietà pubblica UpdateParameters Ottiene l'insieme di parametri che contiene i parametri utilizzati dalla proprietà UpdateCommand dal controllo SqlDataSourceView associato al controllo SqlDataSource.
Proprietà protetta. ViewState Ottiene un dizionario di informazioni sullo stato che permette di salvare e ripristinare lo stato di visualizzazione di un controllo server attraverso più richieste per la stessa pagina. (Ereditato da Control)
Proprietà protetta. ViewStateIgnoresCase Ottiene un valore che indica se l'oggetto StateBag non effettua la distinzione tra maiuscole e minuscole. (Ereditato da Control)
Proprietà pubblica ViewStateMode Ottiene o imposta la modalità dello stato, visualizzazione di questo controllo. (Ereditato da Control)
Proprietà pubblica Visible Ottiene o imposta un valore che indica se il controllo è visualizzato. (Ereditato da DataSourceControl)
In alto
Metodi
  Nome Descrizione
Metodo protetto AddedControl Viene chiamato dopo che un controllo è stato aggiunto all'insieme Controls dell'oggetto Control. (Ereditato da Control)
Metodo protetto AddParsedSubObject Notifica al controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto ControlCollection del controllo server. (Ereditato da Control)
Metodo pubblico ApplyStyleSheetSkin Applica al controllo le proprietà di stile definite nel foglio di stile della pagina. (Ereditato da DataSourceControl)
Metodo protetto BuildProfileTree Infrastruttura. Raccoglie informazioni sul controllo server e le recapita alla proprietà Trace in modo che vengano visualizzate quando è attivata la tracciatura per la pagina. (Ereditato da Control)
Metodo protetto ClearCachedClientID Infrastruttura. Imposta il valore memorizzato nella cache ClientID su null. (Ereditato da Control)
Metodo protetto ClearChildControlState Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server. (Ereditato da Control)
Metodo protetto ClearChildState Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server. (Ereditato da Control)
Metodo protetto ClearChildViewState Elimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server. (Ereditato da Control)
Metodo protetto ClearEffectiveClientIDMode Infrastruttura. Imposta la proprietà ClientIDMode dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit. (Ereditato da Control)
Metodo protetto CreateChildControls Viene chiamato dal framework della pagina ASP.NET per notificare ai controlli server che utilizzano un'implementazione basata sulla composizione di creare gli eventuali controlli figlio in essi contenuti per la preparazione al postback o al rendering. (Ereditato da Control)
Metodo protetto CreateControlCollection Crea un insieme per l'archiviazione di controlli figlio. (Ereditato da DataSourceControl)
Metodo protetto CreateDataSourceView Crea un oggetto visualizzazione origine dati associato al controllo origine dati.
Metodo pubblico DataBind() Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio. (Ereditato da Control)
Metodo protetto DataBind(Boolean) Associa un'origine dati al controllo server chiamato e ai relativi controlli figlio con un'opzione per generare l'evento DataBinding. (Ereditato da Control)
Metodo protetto DataBindChildren Associa un'origine dati al controllo server e ai relativi controlli figlio. (Ereditato da Control)
Metodo pubblico Delete Esegue un'operazione di eliminazione utilizzando la stringa SQL DeleteCommand e tutti i parametri nell'insieme DeleteParameters.
Metodo pubblico Dispose Abilita un controllo server alla pulizia finale prima che venga rilasciato dalla memoria. (Ereditato da Control)
Metodo protetto EnsureChildControls Determina se il controllo server contiene controlli figlio. In caso contrario, li crea. (Ereditato da Control)
Metodo protetto EnsureID Crea un identificatore per i controlli a cui non è assegnato alcun identificatore. (Ereditato da Control)
Metodo pubblico Equals(Object) Determina se l'oggetto Object specificato è uguale all'oggetto Object corrente. (Ereditato da Object)
Metodo protetto Finalize Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulitura prima che l'oggetto stesso venga recuperato dalla procedura di Garbage Collection. (Ereditato da Object)
Metodo pubblico FindControl(String) Cerca un controllo server nel contenitore dei nomi corrente con il parametro id specificato. (Ereditato da DataSourceControl)
Metodo protetto FindControl(String, Int32) Infrastruttura. Cerca nel contenitore di denominazione corrente un controllo server con il parametro id indicato e un intero, specificato nel parametro pathOffset, che agevola la ricerca. Non eseguire l'override di questa versione del metodo FindControl. (Ereditato da Control)
Metodo pubblico Focus Imposta lo stato attivo per l'input del controllo. (Ereditato da DataSourceControl)
Metodo protetto GetDbProviderFactory Restituisce l'oggetto DbProviderFactory associato al provider ADO.NET identificato dalla proprietà ProviderName.
Metodo protetto GetDesignModeState Infrastruttura. Ottiene i dati della fase di progettazione per un controllo. (Ereditato da Control)
Metodo pubblico GetHashCode Funge da funzione hash per un determinato tipo. (Ereditato da Object)
Metodo pubblico GetRouteUrl(Object) Ottiene l'URL corrispondente a un set di parametri di route. (Ereditato da Control)
Metodo pubblico GetRouteUrl(RouteValueDictionary) Ottiene l'URL corrispondente a un set di parametri di route. (Ereditato da Control)
Metodo pubblico GetRouteUrl(String, Object) Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route. (Ereditato da Control)
Metodo pubblico GetRouteUrl(String, RouteValueDictionary) Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route. (Ereditato da Control)
Metodo pubblico GetType Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Metodo pubblico GetUniqueIDRelativeTo Restituisce la parte con prefisso della proprietà UniqueID del controllo specificato. (Ereditato da Control)
Metodo protetto GetView Ottiene la visualizzazione origine dati denominata associata al controllo origine dati. (Esegue l'override di DataSourceControl.GetView(String)).
Metodo protetto GetViewNames Ottiene un insieme di nomi che rappresentano l'elenco di oggetti visualizzazione associati al controllo SqlDataSource. (Esegue l'override di DataSourceControl.GetViewNames()).
Metodo pubblico HasControls Determina se il controllo server contiene controlli figlio. (Ereditato da DataSourceControl)
Metodo protetto HasEvents Restituisce un valore che indica se gli eventi vengono registrati per il controllo o eventuali controlli figlio. (Ereditato da Control)
Metodo pubblico Insert Esegue un'operazione di inserimento utilizzando la stringa SQL InsertCommand e tutti i parametri nell'insieme InsertParameters.
Metodo protetto IsLiteralContent Infrastruttura. Determina se il controllo server conserva solo il contenuto literal. (Ereditato da Control)
Metodo protetto LoadControlState Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal metodo SaveControlState. (Ereditato da Control)
Metodo protetto LoadViewState Infrastruttura. Carica nel controllo SqlDataSource lo stato delle proprietà che devono essere mantenute. (Esegue l'override di Control.LoadViewState(Object)).
Metodo protetto MapPathSecure Recupera il percorso fisico al quale è associato un percorso virtuale, assoluto o relativo. (Ereditato da Control)
Metodo protetto MemberwiseClone Consente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
Metodo protetto OnBubbleEvent Determina se l'evento per il controllo server è passato alla gerarchia del controllo server dell'interfaccia utente della pagina. (Ereditato da Control)
Metodo protetto OnDataBinding Genera l'evento DataBinding. (Ereditato da Control)
Metodo protetto OnInit Aggiunge un gestore eventi LoadComplete al controllo Page che contiene il controllo SqlDataSource. (Esegue l'override di Control.OnInit(EventArgs)).
Metodo protetto OnLoad Genera l'evento Load. (Ereditato da Control)
Metodo protetto OnPreRender Genera l'evento PreRender. (Ereditato da Control)
Metodo protetto OnUnload Genera l'evento Unload. (Ereditato da Control)
Metodo protetto OpenFile Ottiene un oggetto Stream utilizzato per leggere un file. (Ereditato da Control)
Metodo protetto RaiseBubbleEvent Assegna eventuali origini dell'evento e relative informazioni al controllo padre. (Ereditato da Control)
Metodo protetto RaiseDataSourceChangedEvent Genera l'evento DataSourceChanged. (Ereditato da DataSourceControl)
Metodo protetto RemovedControl Viene chiamato dopo la rimozione di un controllo figlio dall'insieme Controls dell'oggetto Control. (Ereditato da Control)
Metodo protetto Render Invia il contenuto del controllo server a un oggetto HtmlTextWriter fornito, che scrive il contenuto di cui si effettuerà il rendering sul client. (Ereditato da Control)
Metodo protetto RenderChildren Invia il contenuto di un controllo figlio del controllo server a un oggetto HtmlTextWriter fornito, che scrive il contenuto di cui verrà effettuato il rendering sul client. (Ereditato da Control)
Metodo pubblico RenderControl(HtmlTextWriter) Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter fornito e memorizza le informazioni di tracciatura relative al controllo se questa funzionalità è attivata. (Ereditato da DataSourceControl)
Metodo protetto RenderControl(HtmlTextWriter, ControlAdapter) Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato utilizzando un oggetto ControlAdapter specificato. (Ereditato da Control)
Metodo protetto ResolveAdapter Ottiene l'adattatore del controllo responsabile del rendering del controllo specificato. (Ereditato da Control)
Metodo pubblico ResolveClientUrl Ottiene un URL che può essere utilizzato dal browser. (Ereditato da Control)
Metodo pubblico ResolveUrl Converte un URL in un formato utilizzabile dal client richiedente. (Ereditato da Control)
Metodo protetto SaveControlState Salva le modifiche allo stato di un controllo server apportate dal momento in cui è stato eseguito il postback della pagina al server. (Ereditato da Control)
Metodo protetto SaveViewState Infrastruttura. Salva lo stato di visualizzazione corrente del controllo SqlDataSource. (Esegue l'override di Control.SaveViewState()).
Metodo pubblico Select Recupera dati dal database sottostante utilizzando la stringa SQL SelectCommand e tutti i parametri dell'insieme SelectParameters.
Metodo protetto SetDesignModeState Imposta i dati della fase di progettazione per un controllo. (Ereditato da Control)
Metodo pubblico SetRenderMethodDelegate Infrastruttura. Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e del relativo contenuto nel controllo padre. (Ereditato da Control)
Metodo pubblico ToString Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Metodo protetto TrackViewState Infrastruttura. Tiene traccia delle modifiche dello stato di visualizzazione del controllo SqlDataSource in modo che possano essere archiviate nell'oggetto System.Web.UI.StateBag per il controllo. (Esegue l'override di Control.TrackViewState()).
Metodo pubblico Update Esegue un'operazione di aggiornamento utilizzando la stringa SQL UpdateCommand e tutti i parametri nell'insieme UpdateParameters.
In alto
Eventi
  Nome Descrizione
Evento pubblico DataBinding Viene generato quando il controllo server viene associato a un'origine dati. (Ereditato da Control)
Evento pubblico Deleted Si verifica quando viene completata un'operazione di eliminazione.
Evento pubblico Deleting Si verifica prima di un'operazione di eliminazione.
Evento pubblico Disposed Si verifica quando un controllo server viene rilasciato dalla memoria, ossia nell'ultima fase della durata di un controllo server quando viene richiesta una pagina ASP.NET. (Ereditato da Control)
Evento pubblico Filtering Si verifica prima di un'operazione di filtro.
Evento pubblico Init Viene generato quando il controllo server viene inizializzato, ovvero nella prima fase della sua durata. (Ereditato da Control)
Evento pubblico Inserted Si verifica quando viene completata un'operazione di inserimento.
Evento pubblico Inserting Si verifica prima di un'operazione di inserimento.
Evento pubblico Load Viene generato quando il controllo server è caricato nell'oggetto Page. (Ereditato da Control)
Evento pubblico PreRender Si verifica dopo il caricamento dell'oggetto Control ma prima del rendering. (Ereditato da Control)
Evento pubblico Selected Si verifica quando viene completata un'operazione di recupero.
Evento pubblico Selecting Si verifica prima di un'operazione di recupero dati.
Evento pubblico Unload Viene generato quando il controllo server viene scaricato dalla memoria. (Ereditato da Control)
Evento pubblico Updated Si verifica quando viene completata un'operazione di aggiornamento.
Evento pubblico Updating Si verifica prima di un'operazione di aggiornamento.
In alto
Metodi di estensione
  Nome Descrizione
Metodo di estensione pubblico FindDataSourceControl Restituisce l'origine dati associata al controllo dati per il controllo specificato. (Definito da DynamicDataExtensions).
Metodo di estensione pubblico FindFieldTemplate Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato. (Definito da DynamicDataExtensions).
Metodo di estensione pubblico FindMetaTable Restituisce l'oggetto metatabella per il controllo contenitore dei dati. (Definito da DynamicDataExtensions).
In alto
Implementazioni esplicite dell'interfaccia
  Nome Descrizione
Implementazione esplicita dell'interfaccia Proprietà privata IControlBuilderAccessor.ControlBuilder Per una descrizione di questo membro, vedere IControlBuilderAccessor.ControlBuilder. (Ereditato da Control)
Implementazione esplicita dell'interfaccia Metodo privato IControlDesignerAccessor.GetDesignModeState Per una descrizione di questo membro, vedere IControlDesignerAccessor.GetDesignModeState. (Ereditato da Control)
Implementazione esplicita dell'interfaccia Metodo privato IControlDesignerAccessor.SetDesignModeState Per una descrizione di questo membro, vedere IControlDesignerAccessor.SetDesignModeState. (Ereditato da Control)
Implementazione esplicita dell'interfaccia Metodo privato IControlDesignerAccessor.SetOwnerControl Infrastruttura. Per una descrizione di questo membro, vedere IControlDesignerAccessor.SetOwnerControl. (Ereditato da Control)
Implementazione esplicita dell'interfaccia Proprietà privata IControlDesignerAccessor.UserData Per una descrizione di questo membro, vedere IControlDesignerAccessor.UserData. (Ereditato da Control)
Implementazione esplicita dell'interfaccia Proprietà privata IDataBindingsAccessor.DataBindings Per una descrizione di questo membro, vedere IDataBindingsAccessor.DataBindings. (Ereditato da Control)
Implementazione esplicita dell'interfaccia Proprietà privata IDataBindingsAccessor.HasDataBindings Per una descrizione di questo membro, vedere IDataBindingsAccessor.HasDataBindings. (Ereditato da Control)
Implementazione esplicita dell'interfaccia Evento privato IDataSource.DataSourceChanged Infrastruttura. Si verifica quando a un controllo origine dati sono state apportate modifiche che influiscono sui controlli con associazione a dati. (Ereditato da DataSourceControl)
Implementazione esplicita dell'interfaccia Metodo privato IDataSource.GetView Infrastruttura. Ottiene l'oggetto DataSourceView denominato associato al controllo DataSourceControl. Alcuni controlli origine dati supportano una sola visualizzazione, mentre altri ne supportano più di una. (Ereditato da DataSourceControl)
Implementazione esplicita dell'interfaccia Metodo privato IDataSource.GetViewNames Infrastruttura. Ottiene un insieme di nomi che rappresentano l'elenco di oggetti DataSourceView associati al controllo DataSourceControl. (Ereditato da DataSourceControl)
Implementazione esplicita dell'interfaccia Proprietà privata IExpressionsAccessor.Expressions Per una descrizione di questo membro, vedere IExpressionsAccessor.Expressions. (Ereditato da Control)
Implementazione esplicita dell'interfaccia Proprietà privata IExpressionsAccessor.HasExpressions Per una descrizione di questo membro, vedere IExpressionsAccessor.HasExpressions. (Ereditato da Control)
Implementazione esplicita dell'interfaccia Proprietà privata IListSource.ContainsListCollection Infrastruttura. Indica se il controllo origine dati è associato a uno o più elenchi di dati. (Ereditato da DataSourceControl)
Implementazione esplicita dell'interfaccia Metodo privato IListSource.GetList Infrastruttura. Ottiene un elenco di controlli origine dati che possono essere utilizzati come origini degli elenchi di dati. (Ereditato da DataSourceControl)
Implementazione esplicita dell'interfaccia Metodo privato IParserAccessor.AddParsedSubObject Per una descrizione di questo membro, vedere IParserAccessor.AddParsedSubObject. (Ereditato da Control)
In alto
Note

In questo argomento:

Introduzione

Il controllo origine dati SqlDataSource rappresenta i dati in un database relazionale di SQL nei controlli con associazione a dati. È possibile utilizzare il controllo SqlDataSource insieme a un controllo con associazione a dati per recuperare dati da un database relazionale e per visualizzare, modificare e ordinare dati in una pagina Web con una quantità ridotta di codice o senza codice.

Connessioni dati

Per la connessione a un database è necessario impostare la proprietà ConnectionString su una stringa di connessione valida. L'oggetto SqlDataSource può supportare qualsiasi database relazionale di SQL a cui è possibile connettersi tramite un provider ADO.NET, ad esempio SqlClient, OleDb, Odbc o OracleClient. Per informazioni sulla protezione delle stringhe di connessione, vedere Procedura: proteggere le stringhe di connessione durante l'utilizzo dei controlli origine dati (la pagina potrebbe essere in inglese).

Per recuperare dati da un database sottostante, impostare la proprietà SelectCommand con una query SQL. Se il database cui è associato SqlDataSource supporta stored procedure, è possibile impostare la proprietà SelectCommand sul nome di una stored procedure. La query SQL specificata può essere anche una query con parametri. È possibile aggiungere oggetti Parameter associati a una query con parametri all'insieme SelectParameters. Per ulteriori informazioni sulle query SQL con parametri e relative sintassi, vedere Utilizzo di parametri con controlli origine dati.

Il controllo SqlDataSource recupera dati ad ogni chiamata del metodo Select. Questo metodo fornisce accesso a livello di codice al metodo specificato dalla proprietà SelectMethod. Il metodo Select viene chiamato automaticamente dai controlli associati all'oggetto SqlDataSource quando viene chiamato il relativo metodo DataBind. Se viene impostata la proprietà DataSourceID di un controllo con associazione a dati, il controllo viene associato automaticamente ai dati dall'origine dati, come richiesto. L'impostazione della proprietà DataSourceID è il metodo consigliato per associare un controllo ObjectDataSource a un controllo con associazione a dati. In alternativa, è possibile utilizzare la proprietà DataSource ma è necessario chiamare in modo esplicito il metodo DataBind del controllo con associazione a dati. Alcuni esempi di controlli con associazione a dati che possono utilizzare l'oggetto SqlDataSource sono DataGrid, DetailsView, DataList e DropDownList. È possibile chiamare il metodo Select a livello di codice in qualsiasi momento per recuperare dati dal database sottostante.

In scenari ASP.NET dichiarativi e a livello di codice, è possibile impostare la proprietà DataSourceID del controllo con associazione a dati sull'ID dell'oggetto SqlDataSource. È inoltre possibile assegnare un'istanza della classe SqlDataSource alla proprietà DataSource del controllo con associazione a dati. Per ulteriori informazioni sull'associazione del controllo con associazione a dati ai controlli origine dati, vedere Cenni preliminari sull'accesso ai dati ASP.NET.

Esecuzione di operazioni sui dati

In base alle funzionalità del prodotto database sottostante e alla configurazione dell'istanza della classe SqlDataSource, è possibile eseguire operazioni sui dati, ad esempio aggiornamenti, inserimenti ed eliminazioni. Per eseguire tali operazioni, impostare il testo del comando appropriato e tutti i parametri associati per l'operazione che si desidera eseguire. Per un'operazione di aggiornamento ad esempio, impostare la proprietà UpdateCommand su una stringa SQL o sul nome di una stored procedure e aggiungere tutti i parametri richiesti all'insieme UpdateParameters. L'aggiornamento viene eseguito quando viene chiamato il metodo Update o in modo esplicito dal codice o automaticamente da un controllo con associazione a dati. Lo stesso modello generale viene seguito per le operazioni dei metodi Delete e Insert.

I comandi e le query SQL che vengono utilizzati nelle proprietà SelectCommand, UpdateCommand, InsertCommand e DeleteCommand possono essere con parametri. Questo indica che la query o il comando può utilizzare segnaposto anziché valori letterali e associare i segnaposto all'applicazione o alle variabili definite dall'utente. È possibile associare parametri nelle query SQL a variabili relative alla sessione, valori passati alla stringa di query per una pagina Web Form, valori della proprietà di altri controlli server e altro ancora. Per ulteriori informazioni su come utilizzare i parametri nelle query SQL con l'oggetto SqlDataSource, vedere Utilizzo di parametri con controlli origine dati e Utilizzo dei parametri con il controllo SqlDataSource.

Nota Nota

Per impostazione predefinita, se quando si esegue un comando Select uno dei parametri è null, non viene restituito alcun dato e non viene generata alcuna eccezione. Per modificare questo comportamento, impostare la proprietà CancelSelectOnNullParameter su false.

Provider di dati

Per impostazione predefinita, il controllo SqlDataSource utilizza il provider di dati .NET Framework per SQL Server, ma l'oggetto SqlDataSource non è specifico di Microsoft SQL Server. È possibile effettuare la connessione del controllo SqlDataSource con qualsiasi prodotto database per il quale esiste un provider ADO.NET gestito. Se utilizzato con il provider System.Data.OleDb, l'oggetto SqlDataSource può utilizzare qualsiasi database conforme a OLE DB. Se utilizzato con il provider System.Data.Odbc, l'oggetto SqlDataSource può essere utilizzato con qualsiasi database e driver ODBC, inclusi IBM DB2, MySQL e PostgreSQL. Se utilizzato con il provider System.Data.OracleClient, l'oggetto SqlDataSource può utilizzare database di Oracle 8.1.7 e versione successiva. L'elenco dei provider disponibili è registrato nella sezione DbProviderFactories del file di configurazione, nel file Machine.config o nel file Web.config. Per ulteriori informazioni, vedere Selezione dei dati tramite il controllo SqlDataSource.

Memorizzazione nella cache

Se i dati vengono visualizzati nella pagina tramite un controllo SqlDataSource, è possibile migliorare le prestazioni della pagina utilizzando le funzionalità di memorizzazione dati nella cache del controllo origine dati. La memorizzazione nella cache riduce il carico di elaborazione sui server database a discapito della memoria sul server Web; nella maggior parte dei casi questa soluzione risulta un buon compromesso. L'oggetto SqlDataSource memorizza automaticamente i dati nella cache quando la proprietà EnableCaching è impostata su true e la proprietà CacheDuration sul numero di secondi durante i quali la cache memorizza i dati prima che la relativa voce venga eliminata. È inoltre possibile specificare una proprietà CacheExpirationPolicy e un valore SqlCacheDependency facoltativo.

Funzionalità aggiuntive

L'oggetto SqlDataSource fornisce funzionalità aggiuntive, come elencato nella tabella riportata di seguito.

Funzionalità

Requisiti

Memorizzazione nella cache

Impostare la proprietà DataSourceMode sul valore DataSet, la proprietà EnableCaching su true e le proprietà CacheDuration e CacheExpirationPolicy in base al comportamento di memorizzazione nella cache che si desidera utilizzare per tutti i dati memorizzati nella cache.

Eliminazione

Impostare la proprietà DeleteCommand su un'istruzione SQL utilizzata per eliminare dati. In genere questa istruzione è con parametri.

Filtraggio

Impostare la proprietà DataSourceMode sul valore DataSet. Impostare la proprietà FilterExpression su un'espressione di filtraggio utilizzata per filtrare i dati quando viene chiamato il metodo Select.

Inserimento

Impostare la proprietà InsertCommand su un'istruzione SQL utilizzata per inserire dati. In genere questa istruzione è con parametri.

Paging

Non supportata attualmente dall'oggetto SqlDataSource, tuttavia alcuni controlli con associazione a dati, ad esempio GridView, supportano questa funzionalità quando la proprietà DataSourceMode viene impostata sul valore DataSet.

Selezione

Impostare la proprietà SelectCommand su un'istruzione SQL utilizzata per recuperare dati.

Ordinamento

Impostare la proprietà DataSourceMode su DataSet.

Aggiornamento

Impostare la proprietà UpdateCommand su un'istruzione SQL utilizzata per aggiornare dati. In genere questa istruzione è con parametri.

Vista origine dati

Come con tutti i controlli origine dati, il controllo SqlDataSource viene associato a una classe relativa alla visualizzazione origine dati. Il controllo SqlDataSource dispone di un solo oggetto SqlDataSourceView associato, denominato sempre Table.

Per il controllo SqlDataSource non è disponibile il rendering visivo. Viene implementato come controllo, pertanto può essere creato in modo dichiarativo e può anche essere impostato in modo da prendere parte alla gestione dello stato. Di conseguenza, l'oggetto SqlDataSource non supporta funzionalità visive, ad esempio quelle fornite dalla proprietà EnableTheming o dalla proprietà SkinID.

Sintassi dichiarativa

<asp:SqlDataSource
    CacheDuration="string|Infinite"
    CacheExpirationPolicy="Absolute|Sliding"
    CacheKeyDependency="string"
    CancelSelectOnNullParameter="True|False"
    ConflictDetection="OverwriteChanges|CompareAllValues"
    ConnectionString="string"
    DataSourceMode="DataReader|DataSet"
    DeleteCommand="string"
    DeleteCommandType="Text|StoredProcedure"
    EnableCaching="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    FilterExpression="string"
    ID="string"
    InsertCommand="string"
    InsertCommandType="Text|StoredProcedure"
    OldValuesParameterFormatString="string"
    OnDataBinding="DataBinding event handler"
    OnDeleted="Deleted event handler"
    OnDeleting="Deleting event handler"
    OnDisposed="Disposed event handler"
    OnFiltering="Filtering event handler"
    OnInit="Init event handler"
    OnInserted="Inserted event handler"
    OnInserting="Inserting event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnSelected="Selected event handler"
    OnSelecting="Selecting event handler"
    OnUnload="Unload event handler"
    OnUpdated="Updated event handler"
    OnUpdating="Updating event handler"
    ProviderName="string|System.Data.Odbc|System.Data.OleDb|
        System.Data.OracleClient|System.Data.SqlClient|
        Microsoft.SqlServerCe.Client"
    runat="server"
    SelectCommand="string"
    SelectCommandType="Text|StoredProcedure"
    SkinID="string"
    SortParameterName="string"
    SqlCacheDependency="string"
    UpdateCommand="string"
    UpdateCommandType="Text|StoredProcedure"
    Visible="True|False"
>
        <DeleteParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </DeleteParameters>
        <FilterParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </FilterParameters>
        <InsertParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </InsertParameters>
        <SelectParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </SelectParameters>
        <UpdateParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </UpdateParameters>
</asp:SqlDataSource>
Esempi

A complemento di questo argomento è disponibile un progetto di sito Web di Visual Studio con codice sorgente che è possibile scaricare.

In questa sezione sono contenuti quattro esempi di codice:

  • Nel primo esempio di codice viene illustrato come visualizzare dati da SQL Server in un controllo GridView utilizzando la sintassi dichiarativa.

  • Nel secondo esempio di codice viene illustrato come visualizzare dati da un database conforme a ODBC in un controllo GridView utilizzando la sintassi dichiarativa.

  • Nel terzo esempio di codice viene illustrato come visualizzare e aggiornare dati in un controllo GridView.

  • Nel quarto esempio di codice viene illustrato come visualizzare e aggiornare dati in un controllo DropDownList.

    Nota Nota

    In questi esempi viene illustrato come utilizzare la sintassi dichiarativa per l'accesso ai dati. Per ulteriori informazioni sull'accesso ai dati tramite il codice invece che tramite il markup, vedere Accesso ai dati in Visual Studio (la pagina potrebbe essere in inglese).

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare un controllo SqlDataSource in modo dichiarativo per recuperare dati da SQL Server e visualizzarli in un controllo GridView.

Visual Basic

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>
C#

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare un controllo SqlDataSource in modo dichiarativo per recuperare dati da un database conforme a ODBC e visualizzarli in un controllo GridView. La proprietà ProviderName è il nome del provider di dati .NET Framework per ODBC, vale a dire System.Data.Odbc.

Visual Basic

<%@Page  Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <!-- This example uses a Northwind database that is hosted by an ODBC-compliant
         database. To run this sample, create an ODBC DSN to any database that hosts
         the Northwind database, including Microsoft SQL Server or Microsoft Access,
         change the name of the DSN in the ConnectionString, and view the page.
    -->
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          DataSourceMode="DataReader"
          ConnectionString="dsn=myodbc3dsn;"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>
C#

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >

  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <!-- This example uses a Northwind database that is hosted by an ODBC-compliant
         database. To run this sample, create an ODBC DSN to any database that hosts
         the Northwind database, including Microsoft SQL Server or Microsoft Access,
         change the name of the DSN in the ConnectionString, and view the page.
    -->
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          DataSourceMode="DataReader"
          ConnectionString="dsn=myodbc3dsn;"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

Nell'esempio di codice riportato di seguito viene illustrato un comune scenario di visualizzazione e aggiornamento con il controllo GridView. Come con gli esempi precedenti, i dati provenienti dal database di Northwind vengono visualizzati nel controllo GridView. Inoltre, dal momento che viene specificata una proprietà UpdateCommand e la proprietà AutoGenerateEditButton viene impostata su true, è possibile modificare e aggiornare record senza ulteriore codice. Il controllo GridView gestisce automaticamente l'aggiunta di parametri all'insieme UpdateParameters e chiama il metodo Update quando viene fatto clic sul pulsante Aggiorna nel controllo GridView.

Visual Basic

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataSet"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
          UpdateCommand="Update Employees SET FirstName=@FirstName,LastName=@LastName,Title=@Title WHERE EmployeeID=@EmployeeID">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AutoGenerateColumns="False"
          DataKeyNames="EmployeeID"
          AutoGenerateEditButton="True"
          DataSourceID="SqlDataSource1">
          <columns>
              <asp:BoundField HeaderText="First Name" DataField="FirstName" />
              <asp:BoundField HeaderText="Last Name" DataField="LastName" />
              <asp:BoundField HeaderText="Title" DataField="Title" />
          </columns>

      </asp:GridView>
    </form>
  </body>
</html>
C#

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataSet"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
          UpdateCommand="Update Employees SET FirstName=@FirstName,LastName=@LastName,Title=@Title WHERE EmployeeID=@EmployeeID">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AutoGenerateColumns="False"
          DataKeyNames="EmployeeID"
          AutoGenerateEditButton="True"
          DataSourceID="SqlDataSource1">
          <columns>
              <asp:BoundField HeaderText="First Name" DataField="FirstName" />
              <asp:BoundField HeaderText="Last Name" DataField="LastName" />
              <asp:BoundField HeaderText="Title" DataField="Title" />
          </columns>

      </asp:GridView>

    </form>
  </body>
</html>

Nell'esempio di codice riportato di seguito viene illustrato uno scenario comune di visualizzazione e aggiornamento con i controlli DropDownList e TextBox. Il controllo DropDownList non aggiunge automaticamente parametri di aggiornamento all'insieme UpdateParameters o chiama il metodo Update come richiesto. I parametri di aggiornamento vengono specificati in modo dichiarativo ed è possibile aggiungere un gestore eventi per eseguire l'operazione del metodo Update quando viene generato un evento.

Nota sulla sicurezza Nota sulla sicurezza

Questo esempio contiene una casella di testo che accetta l'input dell'utente e rappresenta quindi un potenziale rischio per la sicurezza. Per impostazione predefinita, le pagine Web ASP.NET convalidano l'input utente in modo che non includa script o elementi HTML. Per ulteriori informazioni, vedere Cenni preliminari sugli attacchi tramite script.

Visual Basic

<%@Page  Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

 Sub On_Click(ByVal source As Object, ByVal e As EventArgs)
    Try
        SqlDataSource1.Update()
    Catch except As Exception
        ' Handle the Exception.
    End Try

    Label2.Text="The record was updated successfully!"

 End Sub 'On_Click
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID, LastName, Address FROM Employees"
          UpdateCommand="UPDATE Employees SET Address=@Address WHERE EmployeeID=@EmployeeID">
          <UpdateParameters>
              <asp:ControlParameter Name="Address" ControlId="TextBox1" PropertyName="Text"/>
              <asp:ControlParameter Name="EmployeeID" ControlId="DropDownList1" PropertyName="SelectedValue"/>
          </UpdateParameters>
      </asp:SqlDataSource>

      <asp:DropDownList
          id="DropDownList1"
          runat="server"
          DataTextField="LastName"
          DataValueField="EmployeeID"
          DataSourceID="SqlDataSource1">
      </asp:DropDownList>

      <br />
      <asp:Label id="Label1" runat="server" Text="Enter a new address for the selected user."
        AssociatedControlID="TextBox1" />
      <asp:TextBox id="TextBox1" runat="server" />
      <asp:Button id="Submit" runat="server" Text="Submit" OnClick="On_Click" />

      <br /><asp:Label id="Label2" runat="server" Text="" />
    </form>
  </body>
</html>
C#

<%@Page  Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
 private void On_Click(Object source, EventArgs e) {
    try {
        SqlDataSource1.Update();
    }
    catch (Exception except) {
        // Handle the Exception.
    }

    Label2.Text="The record was updated successfully!";
 }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID, LastName, Address FROM Employees"
          UpdateCommand="UPDATE Employees SET Address=@Address WHERE EmployeeID=@EmployeeID">
          <UpdateParameters>
              <asp:ControlParameter Name="Address" ControlId="TextBox1" PropertyName="Text"/>
              <asp:ControlParameter Name="EmployeeID" ControlId="DropDownList1" PropertyName="SelectedValue"/>
          </UpdateParameters>
      </asp:SqlDataSource>

      <asp:DropDownList
          id="DropDownList1"
          runat="server"
          DataTextField="LastName"
          DataValueField="EmployeeID"
          DataSourceID="SqlDataSource1">
      </asp:DropDownList>

      <br />
      <asp:Label id="Label1" runat="server" Text="Enter a new address for the selected user."
        AssociatedControlID="TextBox1" />
      <asp:TextBox id="TextBox1" runat="server" />
      <asp:Button id="Submit" runat="server" Text="Submit" OnClick="On_Click" />

      <br /><asp:Label id="Label2" runat="server" Text="" />

    </form>
  </body>
</html>
Informazioni sulla versione

.NET Framework

Supportato in: 4, 3.5, 3.0, 2.0
Piattaforme

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Codice thread safe
Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.
Vedere anche

Riferimenti

Spazio dei nomi System.Web.UI.WebControls
SqlDataSourceView
AccessDataSource
DataSourceControl

Altre risorse

Accesso ai dati in Visual Studio
Cenni preliminari sull'accesso ai dati ASP.NET
Controlli server Web dell'origine dati
Cenni preliminari sul controllo server Web SqlDataSource
Cenni preliminari sul ciclo di vita di una pagina ASP.NET