Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe SqlDataSourceView

 

Data di pubblicazione: ottobre 2016

Supporta il controllo SqlDataSource e fornisce un'interfaccia per i controlli associati a dati per l'esecuzione di operazioni sui dati SQL in database relazionali.

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

System.Object
  System.Web.UI.DataSourceView
    System.Web.UI.WebControls.SqlDataSourceView
      System.Web.UI.WebControls.AccessDataSourceView

public class SqlDataSourceView : DataSourceView, IStateManager

NomeDescrizione
System_CAPS_pubmethodSqlDataSourceView(SqlDataSource, String, HttpContext)

Inizializza una nuova istanza di SqlDataSourceView classe impostando specificato SqlDataSource controllo come proprietario della vista corrente.

NomeDescrizione
System_CAPS_pubpropertyCancelSelectOnNullParameter

Ottiene o imposta un valore che indica se un'operazione di recupero dati è stata annullata quando dei parametri che è contenuto nel SelectParameters raccolta valutata null.

System_CAPS_pubpropertyCanDelete

Ottiene un valore che indica se il SqlDataSourceView oggetto associato all'oggetto corrente SqlDataSource controllo supporta l'operazione di eliminazione.(Esegue l'override di DataSourceView.CanDelete.)

System_CAPS_pubpropertyCanInsert

Ottiene un valore che indica se il SqlDataSourceView oggetto associato all'oggetto corrente SqlDataSource controllo supporta l'operazione di inserimento.(Esegue l'override di DataSourceView.CanInsert.)

System_CAPS_pubpropertyCanPage

Ottiene un valore che indica se il SqlDataSourceView oggetto associato all'oggetto corrente SqlDataSource supporta il paging dei dati recuperati.(Esegue l'override di DataSourceView.CanPage.)

System_CAPS_pubpropertyCanRetrieveTotalRowCount

Ottiene un valore che indica se il SqlDataSourceView oggetto associato all'oggetto corrente SqlDataSource controllo supporta il recupero del numero totale di righe di dati, oltre al set di dati.(Esegue l'override di DataSourceView.CanRetrieveTotalRowCount.)

System_CAPS_pubpropertyCanSort

Ottiene un valore che indica se il SqlDataSourceView oggetto associato all'oggetto corrente SqlDataSource controllo supporta una visualizzazione ordinata dei dati recuperati.(Esegue l'override di DataSourceView.CanSort.)

System_CAPS_pubpropertyCanUpdate

Ottiene un valore che indica se il SqlDataSourceView oggetto associato all'oggetto corrente SqlDataSource controllo supporta l'operazione di aggiornamento.(Esegue l'override di DataSourceView.CanUpdate.)

System_CAPS_pubpropertyConflictDetection

Ottiene o imposta il valore che indica come la SqlDataSource controllo esegue aggiornamenti ed eliminazioni quando i dati in una riga sottostante database le modifiche apportate durante la fase dell'operazione.

System_CAPS_pubpropertyDeleteCommand

Ottiene o imposta la stringa SQL che il SqlDataSourceView viene utilizzata per eliminare dati dal database sottostante.

System_CAPS_pubpropertyDeleteCommandType

Ottiene o imposta un valore che indica se il testo di DeleteCommand proprietà è un'istruzione SQL o il nome di una stored procedure.

System_CAPS_pubpropertyDeleteParameters

Ottiene la raccolta di parametri contenente i parametri utilizzati dal DeleteCommand proprietà.

System_CAPS_protpropertyEvents

Ottiene un elenco di delegati del gestore eventi per la vista origine dati.(Ereditato da DataSourceView.)

System_CAPS_pubpropertyFilterExpression

Ottiene o imposta un'espressione di filtro che viene applicato quando il Select viene chiamato il metodo.

System_CAPS_pubpropertyFilterParameters

Ottiene una raccolta di parametri associati a tutti i segnaposto di parametro nel FilterExpression stringa.

System_CAPS_pubpropertyInsertCommand

Ottiene o imposta la stringa SQL che il SqlDataSourceView oggetto utilizzato per inserire dati nel database sottostante.

System_CAPS_pubpropertyInsertCommandType

Ottiene o imposta un valore che indica se il testo di InsertCommand proprietà è un'istruzione SQL o il nome di una stored procedure.

System_CAPS_pubpropertyInsertParameters

Ottiene la raccolta di parametri contenente i parametri utilizzati dal InsertCommand proprietà.

System_CAPS_protpropertyIsTrackingViewState

Ottiene un valore che indica se il SqlDataSourceView oggetto Salva le modifiche apportate al relativo stato di visualizzazione.

System_CAPS_pubpropertyName

Ottiene il nome della vista origine dati.(Ereditato da DataSourceView.)

System_CAPS_pubpropertyOldValuesParameterFormatString

Ottiene o imposta una stringa di formato da applicare ai nomi dei parametri passati al Delete o Update (metodo).

System_CAPS_protpropertyParameterPrefix

Ottiene la stringa che viene utilizzata come prefisso un segnaposto di parametro in una query SQL con parametri.

System_CAPS_pubpropertySelectCommand

Ottiene o imposta la stringa SQL che il SqlDataSourceView oggetto utilizzato per recuperare dati dal database sottostante.

System_CAPS_pubpropertySelectCommandType

Ottiene o imposta un valore che indica se il testo di SelectCommand proprietà è una query SQL o il nome di una stored procedure.

System_CAPS_pubpropertySelectParameters

Ottiene la raccolta di parametri contenente i parametri utilizzati dal SelectCommand proprietà.

System_CAPS_pubpropertySortParameterName

Ottiene o imposta il nome di un parametro di stored procedure utilizzata per ordinare i dati recuperati durante il recupero dei dati viene eseguita utilizzando una stored procedure.

System_CAPS_pubpropertyUpdateCommand

Ottiene o imposta la stringa SQL che il SqlDataSourceView oggetto utilizzato per aggiornare i dati nel database sottostante.

System_CAPS_pubpropertyUpdateCommandType

Ottiene o imposta un valore che indica se il testo di UpdateCommand proprietà è un'istruzione SQL o il nome di una stored procedure.

System_CAPS_pubpropertyUpdateParameters

Ottiene la raccolta di parametri contenente i parametri utilizzati dal UpdateCommand proprietà.

NomeDescrizione
System_CAPS_pubmethodCanExecute(String)

Determina se può essere eseguito il comando specificato.(Ereditato da DataSourceView.)

System_CAPS_pubmethodDelete(IDictionary, IDictionary)

Esegue un'operazione delete usando il DeleteCommand stringa SQL, i parametri specificati in modo di DeleteParameters raccolta e i valori siano keys e oldValues raccolte.

System_CAPS_pubmethodDelete(IDictionary, IDictionary, DataSourceViewOperationCallback)

Esegue un'operazione di eliminazione asincrona sull'elenco di dati che il DataSourceView oggetto rappresenta.(Ereditato da DataSourceView.)

System_CAPS_pubmethodEquals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object.)

System_CAPS_protmethodExecuteCommand(String, IDictionary, IDictionary)

Esegue il comando specificato.(Ereditato da DataSourceView.)

System_CAPS_pubmethodExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)

Esegue il comando specificato.(Ereditato da DataSourceView.)

System_CAPS_protmethodExecuteDelete(IDictionary, IDictionary)

Esegue un'operazione delete usando il DeleteCommand stringa SQL, i parametri specificati in modo di DeleteParameters raccolta e i valori siano keys e oldValues raccolte.(Esegue l'override di DataSourceView.ExecuteDelete(IDictionary, IDictionary).)

System_CAPS_protmethodExecuteInsert(IDictionary)

Esegue un'operazione insert usando il InsertCommand stringa SQL, i parametri specificati in modo di InsertParameters raccolta e i valori siano values insieme.(Esegue l'override di DataSourceView.ExecuteInsert(IDictionary).)

System_CAPS_protmethodExecuteSelect(DataSourceSelectArguments)

Recupera dati dal database sottostante tramite il SelectCommand stringa SQL e i parametri che sono nel SelectParameters insieme.(Esegue l'override di DataSourceView.ExecuteSelect(DataSourceSelectArguments).)

System_CAPS_protmethodExecuteUpdate(IDictionary, IDictionary, IDictionary)

Esegue un'operazione di aggiornamento utilizzando il UpdateCommand stringa SQL, i parametri presenti il UpdateParameters raccolta e i valori siano keys, values, e oldValues raccolte.(Esegue l'override di DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary).)

System_CAPS_protmethodFinalize()

Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga reclamato dalla procedura di Garbage Collection. (Ereditato da Object.)

System_CAPS_pubmethodGetHashCode()

Funge da funzione hash predefinita.(Ereditato da Object.)

System_CAPS_pubmethodGetType()

Ottiene l'oggetto Type dell'istanza corrente.(Ereditato da Object.)

System_CAPS_pubmethodInsert(IDictionary)

Esegue un'operazione insert usando il InsertCommand stringa SQL, i parametri specificati in modo di InsertParameters raccolta e i valori siano values insieme.

System_CAPS_pubmethodInsert(IDictionary, DataSourceViewOperationCallback)

Esegue un'operazione di inserimento asincrona nell'elenco di dati che il DataSourceView oggetto rappresenta.(Ereditato da DataSourceView.)

System_CAPS_protmethodLoadViewState(Object)

Ripristina lo stato di visualizzazione precedentemente salvato per la vista origine dati.

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.(Ereditato da Object.)

System_CAPS_protmethodOnDataSourceViewChanged(EventArgs)

Genera l'evento DataSourceViewChanged.(Ereditato da DataSourceView.)

System_CAPS_protmethodOnDeleted(SqlDataSourceStatusEventArgs)

Genera il Deleted evento dopo il SqlDataSource controllo ha completato un'operazione di eliminazione.

System_CAPS_protmethodOnDeleting(SqlDataSourceCommandEventArgs)

Genera il Deleting evento prima di SqlDataSource controllo tenta un'operazione di eliminazione.

System_CAPS_protmethodOnFiltering(SqlDataSourceFilteringEventArgs)

Genera il Filtering evento prima di SqlDataSource controllo consente di filtrare i risultati di un'operazione select.

System_CAPS_protmethodOnInserted(SqlDataSourceStatusEventArgs)

Genera il Inserted evento dopo il SqlDataSource controllo ha completato un'operazione di inserimento.

System_CAPS_protmethodOnInserting(SqlDataSourceCommandEventArgs)

Genera il Inserting evento prima di SqlDataSource controllo tenta un'operazione di inserimento.

System_CAPS_protmethodOnSelected(SqlDataSourceStatusEventArgs)

Genera il Selected evento dopo il SqlDataSource controllo ha completato un'operazione di recupero dati.

System_CAPS_protmethodOnSelecting(SqlDataSourceSelectingEventArgs)

Genera il Selecting evento prima di SqlDataSource controllo tenta un'operazione di recupero dati.

System_CAPS_protmethodOnUpdated(SqlDataSourceStatusEventArgs)

Genera il Updated evento dopo il SqlDataSource controllo ha completato un'operazione di aggiornamento.

System_CAPS_protmethodOnUpdating(SqlDataSourceCommandEventArgs)

Genera il Updating evento prima di SqlDataSource controllo tenta un'operazione di aggiornamento.

System_CAPS_protmethodRaiseUnsupportedCapabilityError(DataSourceCapabilities)

Vengono confrontate le funzionalità richieste per un ExecuteSelect operazione con quelle supportate dalla visualizzazione e viene chiamato dal RaiseUnsupportedCapabilitiesError metodo.(Esegue l'override di DataSourceView.RaiseUnsupportedCapabilityError(DataSourceCapabilities).)

System_CAPS_protmethodSaveViewState()

Salva le modifiche apportate allo stato di visualizzazione per il SqlDataSourceView dal momento in cui è stata eseguita il postback della pagina server di controllo.

System_CAPS_pubmethodSelect(DataSourceSelectArguments)

Recupera dati dal database sottostante tramite il SelectCommand stringa SQL e i parametri che sono nel SelectParameters insieme.

System_CAPS_pubmethodSelect(DataSourceSelectArguments, DataSourceViewSelectCallback)

Ottiene un elenco di dati in modo asincrono dall'archivio dati sottostante.(Ereditato da DataSourceView.)

System_CAPS_pubmethodToString()

Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object.)

System_CAPS_protmethodTrackViewState()

Fa in modo che l'oggetto SqlDataSourceView tenga traccia delle modifiche apportate al relativo stato di visualizzazione in modo che possano essere archiviate nell'oggetto StateBag del controllo e mantenute nelle richieste della stessa pagina.

System_CAPS_pubmethodUpdate(IDictionary, IDictionary, IDictionary)

Esegue un'operazione di aggiornamento utilizzando il UpdateCommand stringa SQL, i parametri presenti il UpdateParameters raccolta e i valori siano keys, values, e oldValues raccolte.

System_CAPS_pubmethodUpdate(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)

Esegue un'operazione di aggiornamento asincrono nell'elenco di dati che il DataSourceView oggetto rappresenta.(Ereditato da DataSourceView.)

NomeDescrizione
System_CAPS_pubeventDataSourceViewChanged

Si verifica quando la vista origine dati è stato modificato.(Ereditato da DataSourceView.)

System_CAPS_pubeventDeleted

Si verifica quando un'operazione di eliminazione è stata completata.

System_CAPS_pubeventDeleting

Si verifica prima che un'operazione di eliminazione.

System_CAPS_pubeventFiltering

Si verifica prima che un'operazione di filtro.

System_CAPS_pubeventInserted

Si verifica quando viene completata un'operazione di inserimento.

System_CAPS_pubeventInserting

Si verifica prima che un'operazione di inserimento.

System_CAPS_pubeventSelected

Si verifica quando un'operazione di recupero dati è stata completata.

System_CAPS_pubeventSelecting

Si verifica prima che un'operazione di recupero dati.

System_CAPS_pubeventUpdated

Si verifica quando viene completata un'operazione di aggiornamento.

System_CAPS_pubeventUpdating

Si verifica prima che un'operazione di aggiornamento.

NomeDescrizione
System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.LoadViewState(Object)

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Per una descrizione di questo membro, vedere IStateManager.LoadViewState(Object).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.SaveViewState()

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Per una descrizione di questo membro, vedere IStateManager.SaveViewState().

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.TrackViewState()

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Per una descrizione di questo membro, vedere TrackViewState.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIStateManager.IsTrackingViewState

Per una descrizione di questo membro, vedere IsTrackingViewState.

La SqlDataSourceView classe è destinata principalmente a essere utilizzato dai controlli con associazione a dati e non come oggetto programmabile nel codice della pagina.

Controlli origine dati ASP.NET contengono uno o più elenchi di dati, rappresentati da oggetti vista origine dati. La SqlDataSourceView classe estende la DataSourceView definisce le funzionalità del SqlDataSource controllo con cui è associata e implementa la funzionalità di base per il controllo origine dati. La SqlDataSourceView classe implementa le funzionalità per il SqlDataSource controllare, tra cui la Select, Update, Insert, e Delete operazioni, ordinamento, filtro e la gestione delle impostazioni che vengono mantenute nella vista stato.

Sebbene il SqlDataSourceView oggetto non è direttamente esposto agli sviluppatori di pagine per il SqlDataSource controllo, molte delle relative proprietà sono. L'operazione più semplice che esegue una vista origine dati è il recupero dei dati dal database sottostante tramite il Select metodo che recupera un IEnumerable raccolta di elementi di dati. La SqlDataSourceView classe implementa il recupero dei dati dai database relazionali mediante query SQL. Le query SQL possono essere parametrizzate per maggiore flessibilità e protezione. I seguenti metodi di recupero dei dati, proprietà ed eventi vengono implementati dalla SqlDataSourceView ed esposti direttamente dal relativo SqlDataSource controllo agli sviluppatori di pagine e altri chiamanti:

Il SqlDataSourceView oggetto supporta l'aggiornamento dei dati in un database relazionale utilizzando i comandi SQL. I comandi SQL possono essere parametri per maggiore flessibilità e protezione. Controlli con associazione a dati, ad esempio il GridView e DetailsView, può essere configurato per eseguire automaticamente gli aggiornamenti mediante il SqlDataSourceView, mentre altri controlli. I seguenti metodi di aggiornamento, proprietà ed eventi vengono implementati dalla SqlDataSourceView ed esposti direttamente dal relativo SqlDataSource controllo per gli sviluppatori di pagine e ad altri chiamanti:

Il SqlDataSourceView supporta l'inserimento di nuove righe di dati in un database relazionale. I comandi SQL specificati nella InsertCommand proprietà può essere parametrizzata per maggiore flessibilità e protezione. Controlli con associazione a dati, ad esempio il GridView e DetailsView, può essere configurato per eseguire inserimenti automaticamente utilizzando il SqlDataSourceView, mentre altri controlli. Inserimento riportati di seguito metodi, proprietà e gli eventi vengono implementati dalla SqlDataSourceView ed esposti direttamente dal relativo SqlDataSource controllo per gli sviluppatori di pagine e ad altri chiamanti:

Il SqlDataSourceView oggetto inoltre supporta l'eliminazione di dati da un database relazionale. Come per altri comandi, comandi che vengono specificati in SQL la DeleteCommand proprietà può essere parametrizzata per maggiore flessibilità e protezione. Controlli con associazione a dati, ad esempio il GridView e DetailsView, può essere configurato per eseguire eliminazioni automaticamente utilizzando il SqlDataSourceView, mentre altri controlli. Metodi, proprietà, di eliminazione riportati di seguito e gli eventi vengono implementati dalla SqlDataSourceView ed esposti direttamente dal relativo SqlDataSource controllo per gli sviluppatori di pagine e ad altri chiamanti:

Il recupero dei dati risulta più efficace quando la clausola che viene utilizzata per filtrare i dati durante il recupero dei dati è dinamica. In altre parole, una query SQL con un valore statico in cui clausola non è così flessibile e potente come una query SQL in cui i valori nella clausola WHERE vengono associati a valori che possono cambiare, ad esempio i valori vengono visualizzati in controlli in una pagina Web Form. Invece di ricompilare un SQL query e impostando il SelectCommand proprietà ogni caricamento della pagina, è possibile utilizzare il FilterExpression e FilterParameters le proprietà per applicare i filtri dinamici per il recupero dei dati. Queste proprietà sono implementate dalla SqlDataSourceView ed esposti direttamente dal relativo SqlDataSource controllo ai controlli associati a dati e ad altri chiamanti.

È possibile ordinare i dati recuperati con il SqlDataSource controllo aggiungendo una clausola ORDER BY, provocando il database per eseguire l'ordinamento automaticamente quando si recuperano dati oppure ordinando i dati in memoria dopo averli recuperati. È possibile fornire un'espressione di ordinamento per il SqlDataSourceView impostando il SortExpression proprietà del DataSourceSelectArguments oggetto passato al Select metodo. La sintassi per la SortExpression proprietà è identica alla sintassi per un DataView.Sort proprietà. Se si utilizza una stored procedure per recuperare i dati, è inoltre possibile utilizzare il SortParameterName proprietà per specificare un parametro che viene utilizzato specificamente per l'ordinamento dei risultati di una chiamata alla stored procedure.

Quando più di un utente può modificare il database contemporaneamente, esiste la possibilità di conflitto di concorrenza. Il SqlDataSource controllo dispone di controlli di concorrenza tramite la SqlDataSource.ConflictDetection proprietà. La funzionalità è implementata nel SqlDataSourceView.ConflictDetection proprietà.

Come molti altri controlli server Web, il SqlDataSourceView implementa il IStateManager interfaccia e utilizza lo stato per tenere traccia di stato nelle richieste di pagine di visualizzazione. Le implementazioni di IsTrackingViewState e proprietà e LoadViewState, SaveViewState, e TrackViewState vengono forniti metodi per abilitare la traccia dello stato di visualizzazione per il controllo. Per altre informazioni, vedere ASP.NET State Management Overview.

.NET Framework
Disponibile da 2.0

I membri statici pubblici ( Condiviso in Visual Basic) di questo tipo è thread safe. Non tutti i membri di istanza sono garantiti come thread safe.

Torna all'inizio
Mostra: