SqlDataSourceView Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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.

public ref class SqlDataSourceView : System::Web::UI::DataSourceView, System::Web::UI::IStateManager

public class SqlDataSourceView : System.Web.UI.DataSourceView, System.Web.UI.IStateManager

type SqlDataSourceView = class
    inherit DataSourceView
    interface IStateManager

Public Class SqlDataSourceView
Inherits DataSourceView
Implements IStateManager

Ereditarietà: Object

DataSourceView
SqlDataSourceView

Derivato: System.Web.UI.WebControls.AccessDataSourceView

Implementazioni: IStateManager

Commenti

La SqlDataSourceView classe è destinata principalmente a essere usata dai controlli associati ai dati e non come oggetto programmabile nel codice della pagina.

ASP.NET controlli origine dati contengono uno o più elenchi di dati, rappresentati dagli oggetti vista origine dati. La SqlDataSourceView classe estende la DataSourceView classe, definisce le funzionalità del SqlDataSource controllo con cui è associato e implementa la funzionalità di base dei dati per il controllo origine dati dati. La SqlDataSourceView classe implementa la funzionalità dei dati per il controllo, tra cui le Selectoperazioni , , Update InserteDelete, l'ordinamento, il SqlDataSource filtro e la gestione delle impostazioni mantenute nello stato di visualizzazione.

Anche se l'oggetto SqlDataSourceView SqlDataSource non è esposto direttamente agli sviluppatori di pagine dal controllo, molte delle relative proprietà sono. L'operazione più di base eseguita da una vista origine dati è il recupero dei dati dal database sottostante usando il Select metodo, che recupera una IEnumerable raccolta di elementi dati. La classe implementa il SqlDataSourceView recupero dei dati dai database relazionali usando query SQL. Le query SQL possono essere parametrizzate per una maggiore flessibilità e sicurezza. I metodi di recupero dei dati, le proprietà e gli eventi seguenti vengono implementati dall'oggetto SqlDataSourceView e esposti direttamente dal controllo SqlDataSource agli sviluppatori di pagine e ad altri chiamanti:

Proprietà SelectCommand
Proprietà SelectParameters
Evento Selecting
Evento Selected

L'oggetto supporta l'aggiornamento SqlDataSourceView dei dati in un database relazionale usando i comandi SQL. I comandi SQL possono essere parametrizzati per una maggiore flessibilità e sicurezza. I controlli associati ai dati, ad esempio e GridView DetailsView, possono essere configurati per eseguire gli aggiornamenti automaticamente usando SqlDataSourceView, mentre altri controlli non possono. I metodi di aggiornamento, le proprietà e gli eventi seguenti vengono implementati dall'oggetto SqlDataSourceView e esposti direttamente dal controllo SqlDataSource agli sviluppatori di pagine e ad altri chiamanti:

Proprietà UpdateCommand
Proprietà UpdateParameters
Evento Updating
Evento Updated

Supporta l'inserimento SqlDataSourceView di nuove righe di dati in un database relazionale. I comandi SQL specificati nella InsertCommand proprietà possono essere parametrizzati per una maggiore flessibilità e sicurezza. I controlli associati ai dati, ad esempio e GridView DetailsView, possono essere configurati per eseguire gli inserimenti automaticamente usando SqlDataSourceView, mentre altri controlli non possono. I metodi di inserimento, le proprietà e gli eventi seguenti vengono implementati dall'oggetto SqlDataSourceView e esposti direttamente dal controllo SqlDataSource agli sviluppatori di pagine e ad altri chiamanti:

Proprietà InsertCommand
Proprietà InsertParameters
Evento Inserting
Evento Inserted

L'oggetto supporta anche l'eliminazione SqlDataSourceView di dati da un database relazionale. Come per altri comandi, i comandi SQL specificati nella DeleteCommand proprietà possono essere parametrizzati per una maggiore flessibilità e sicurezza. I controlli associati ai dati, ad esempio e GridView DetailsView, possono essere configurati per eseguire le eliminazioni automaticamente usando SqlDataSourceView, mentre altri controlli non possono. I metodi di eliminazione, le proprietà e gli eventi seguenti vengono implementati dall'oggetto SqlDataSourceView e esposti direttamente dal controllo SqlDataSource agli sviluppatori di pagine e ad altri chiamanti:

Proprietà DeleteCommand
Proprietà DeleteParameters
Evento Deleting
Evento Deleted

Il recupero dei dati è più potente quando la clausola usata per filtrare i dati durante il recupero dei dati è dinamica. In altre parole, una query SQL con una clausola WHERE statica non è flessibile e potente come una query SQL in cui i valori della clausola WHERE sono associati a valori che possono cambiare, ad esempio i valori visualizzati nei controlli in una pagina Web Forms. Anziché ricompilare una query SQL e impostare la proprietà su ogni carico di pagina, è possibile usare le FilterExpression proprietà e FilterParameters per applicare il SelectCommand filtro dinamico al recupero dei dati. Queste proprietà vengono implementate dall'oggetto SqlDataSourceView e esposte direttamente dal SqlDataSource controllo ai controlli associati ai dati e ad altri chiamanti.

È possibile ordinare i dati recuperati con il controllo aggiungendo una clausola ORDER BY, che causa l'esecuzione dell'ordinamento SqlDataSource del database quando si recuperano dati o ordinando i dati in memoria dopo il recupero. È possibile fornire un'espressione di ordinamento all'impostando SqlDataSourceView la SortExpression proprietà dell'oggetto DataSourceSelectArguments passato al Select metodo . La sintassi per la SortExpression proprietà è la stessa della sintassi per una DataView.Sort proprietà. Se si usa una stored procedure per recuperare i dati, è anche possibile usare la SortParameterName proprietà per specificare un parametro utilizzato in modo specifico per ordinare i risultati di una chiamata di stored procedure.

Quando più utenti possono modificare il database simultaneamente, esiste il potenziale di conflitto di concorrenza. Il SqlDataSource controllo dispone di controlli di concorrenza tramite la SqlDataSource.ConflictDetection proprietà . La funzionalità viene implementata nella SqlDataSourceView.ConflictDetection proprietà .

Come molti altri controlli server Web, l'interfaccia SqlDataSourceView implementa l'interfaccia e usa lo stato di visualizzazione per tenere traccia dello IStateManager stato tra le richieste di pagina. Vengono fornite implementazioni della IsTrackingViewState proprietà e e dei LoadViewStatemetodi , SaveViewStatee TrackViewState per abilitare il rilevamento dello stato di visualizzazione per il controllo. Per altre informazioni, vedere Panoramica ASP.NET Gestione stato.

Costruttori

SqlDataSourceView(SqlDataSource, String, HttpContext)

Inizializza una nuova istanza della classe SqlDataSourceView impostando il controllo SqlDataSource specificato come proprietario della visualizzazione corrente.

Proprietà

CancelSelectOnNullParameter	Ottiene o imposta un valore indicante se un'operazione di recupero dati viene annullata quando qualsiasi parametro contenuto nell'insieme SelectParameters restituisce `null`.
CanDelete	Ottiene un valore che indica se l'oggetto SqlDataSourceView associato all'oggetto SqlDataSource corrente supporta l'operazione di eliminazione.
CanInsert	Ottiene un valore che indica se l'oggetto SqlDataSourceView associato al controllo SqlDataSource corrente supporta l'operazione di inserimento.
CanPage	Ottiene un valore che indica se l'oggetto SqlDataSourceView associato all'oggetto SqlDataSource corrente supporta il paging dei dati recuperati.
CanRetrieveTotalRowCount	Ottiene un valore che indica se l'oggetto SqlDataSourceView associato al controllo SqlDataSource corrente supporta il recupero del numero totale di righe di dati, oltre all'insieme di dati.
CanSort	Ottiene un valore che indica se l'oggetto SqlDataSourceView associato all'oggetto SqlDataSource corrente supporta una visualizzazione ordinata dei dati recuperati.
CanUpdate	Ottiene un valore che indica se l'oggetto SqlDataSourceView associato al controllo SqlDataSource corrente supporta l'operazione di aggiornamento.
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.
DeleteCommand	Ottiene o imposta la stringa SQL utilizzata dall'oggetto SqlDataSourceView per eliminare dati dal database sottostante.
DeleteCommandType	Ottiene o imposta un valore indicante se il testo nella proprietà DeleteCommand è un'istruzione SQL o il nome di una stored procedure.
DeleteParameters	Ottiene l'insieme di parametri che contiene i parametri utilizzati dalla proprietà DeleteCommand.
Events	Ottiene un elenco di delegati del gestore eventi per la visualizzazione origine dati. (Ereditato da DataSourceView)
FilterExpression	Ottiene o imposta un'espressione di filtro che viene applicata quando il metodo Select viene chiamato.
FilterParameters	Ottiene un insieme di parametri associati ai segnaposto di parametro nella stringa FilterExpression.
InsertCommand	Ottiene o imposta la stringa SQL utilizzata dall'oggetto SqlDataSourceView per inserire dati nel database sottostante.
InsertCommandType	Ottiene o imposta un valore indicante se il testo nella proprietà InsertCommand è un'istruzione SQL o il nome di una stored procedure.
InsertParameters	Ottiene l'insieme di parametri che contiene i parametri utilizzati dalla proprietà InsertCommand.
IsTrackingViewState	Ottiene un valore che indica se l'oggetto SqlDataSourceView sta salvando le modifiche apportate al relativo stato di visualizzazione.
Name	Ottiene il nome della visualizzazione origine dati. (Ereditato da DataSourceView)
OldValuesParameterFormatString	Ottiene o imposta una stringa di formato da applicare ai nomi di tutti i parametri passati al metodo Delete o Update.
ParameterPrefix	Ottiene la stringa utilizzata come prefisso per un segnaposto di parametro in una query SQL che dispone di parametri.
SelectCommand	Ottiene o imposta la stringa SQL utilizzata dall'oggetto SqlDataSourceView per recuperare dati dal database sottostante.
SelectCommandType	Ottiene o imposta un valore indicante se il testo nella proprietà SelectCommand è una query SQL o il nome di una stored procedure.
SelectParameters	Ottiene l'insieme di parametri che contiene i parametri utilizzati dalla proprietà SelectCommand.
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.
UpdateCommand	Ottiene o imposta la stringa SQL utilizzata dall'oggetto SqlDataSourceView per aggiornare i dati nel database sottostante.
UpdateCommandType	Ottiene o imposta un valore indicante se il testo nella proprietà UpdateCommand è un'istruzione SQL o il nome di una stored procedure.
UpdateParameters	Ottiene l'insieme di parametri che contiene i parametri utilizzati dalla proprietà UpdateCommand.

Metodi

CanExecute(String)	Determina se è possibile eseguire il comando specificato. (Ereditato da DataSourceView)
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Esegue un'operazione di eliminazione asincrona sull'elenco di dati rappresentato dall'oggetto DataSourceView. (Ereditato da DataSourceView)
Delete(IDictionary, IDictionary)	Esegue un'operazione di eliminazione utilizzando la stringa SQL DeleteCommand, tutti i parametri specificati nell'insieme DeleteParameters e i valori contenuti negli insiemi `keys` e `oldValues` specificati.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	Esegue il comando specificato. (Ereditato da DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary)	Esegue il comando specificato. (Ereditato da DataSourceView)
ExecuteDelete(IDictionary, IDictionary)	Esegue un'operazione di eliminazione utilizzando la stringa SQL DeleteCommand, tutti i parametri specificati nell'insieme DeleteParameters e i valori contenuti negli insiemi `keys` e `oldValues` specificati.
ExecuteInsert(IDictionary)	Esegue un'operazione di inserimento utilizzando la stringa SQL InsertCommand, tutti i parametri specificati nell'insieme InsertParameters e i valori dell'insieme `values` specificato.
ExecuteSelect(DataSourceSelectArguments)	Recupera dati dal database sottostante utilizzando la stringa SQL SelectCommand e tutti i parametri dell'insieme SelectParameters.
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Esegue un'operazione di aggiornamento utilizzando la stringa SQL UpdateCommand tutti i parametri specificati nell'insieme UpdateParameters e i valori degli insiemi `keys`, `values` e `oldValues` specificati.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Insert(IDictionary, DataSourceViewOperationCallback)	Esegue un'operazione di inserimento asincrona sull'elenco di dati rappresentato dall'oggetto DataSourceView. (Ereditato da DataSourceView)
Insert(IDictionary)	Esegue un'operazione di inserimento utilizzando la stringa SQL InsertCommand, tutti i parametri specificati nell'insieme InsertParameters e i valori dell'insieme `values` specificato.
LoadViewState(Object)	Ripristina lo stato di visualizzazione precedentemente salvato per la visualizzazione origine dati.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnDataSourceViewChanged(EventArgs)	Genera l'evento DataSourceViewChanged. (Ereditato da DataSourceView)
OnDeleted(SqlDataSourceStatusEventArgs)	Genera l'evento Deleted dopo che il controllo SqlDataSource ha completato un'operazione di eliminazione.
OnDeleting(SqlDataSourceCommandEventArgs)	Genera l'evento Deleting prima del tentativo, da parte del controllo SqlDataSource, di eseguire un'operazione di eliminazione.
OnFiltering(SqlDataSourceFilteringEventArgs)	Genera l'evento Filtering prima che il controllo SqlDataSource filtri il risultato di un'operazione di selezione.
OnInserted(SqlDataSourceStatusEventArgs)	Genera l'evento Inserted dopo che il controllo SqlDataSource ha completato un'operazione di inserimento.
OnInserting(SqlDataSourceCommandEventArgs)	Genera l'evento Inserting prima del tentativo del controllo SqlDataSource di eseguire un'operazione di inserimento.
OnSelected(SqlDataSourceStatusEventArgs)	Genera l'evento Selected dopo che il controllo SqlDataSource ha completato un'operazione di recupero dati.
OnSelecting(SqlDataSourceSelectingEventArgs)	Genera l'evento Selecting prima del tentativo, da parte del controllo SqlDataSource, di eseguire un'operazione di recupero dati.
OnUpdated(SqlDataSourceStatusEventArgs)	Genera l'evento Updated dopo che il controllo SqlDataSource ha completato un'operazione di aggiornamento.
OnUpdating(SqlDataSourceCommandEventArgs)	Genera l'evento Updating prima del tentativo del controllo SqlDataSource di eseguire un'operazione di aggiornamento.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Confronta le funzionalità richieste per un'operazione ExecuteSelect(DataSourceSelectArguments) con quelle supportate dalla visualizzazione e viene chiamato dal metodo RaiseUnsupportedCapabilitiesError(DataSourceView).
SaveViewState()	Salva le modifiche allo stato di visualizzazione per il SqlDataSourceView controllo dal momento in cui la pagina è stata pubblicata nel server.
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	Ottiene un elenco di dati dall'archivio dati sottostante in modo asincrono. (Ereditato da DataSourceView)
Select(DataSourceSelectArguments)	Recupera dati dal database sottostante utilizzando la stringa SQL SelectCommand e tutti i parametri dell'insieme SelectParameters.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
TrackViewState()	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.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Esegue un'operazione di aggiornamento asincrona sull'elenco di dati rappresentato dall'oggetto DataSourceView. (Ereditato da DataSourceView)
Update(IDictionary, IDictionary, IDictionary)	Esegue un'operazione di aggiornamento utilizzando la stringa SQL UpdateCommand tutti i parametri specificati nell'insieme UpdateParameters e i valori degli insiemi `keys`, `values` e `oldValues` specificati.

Eventi

DataSourceViewChanged	Si verifica quando la visualizzazione origine dati ha subito una modifica. (Ereditato da DataSourceView)
Deleted	Si verifica quando viene completata un'operazione di eliminazione.
Deleting	Si verifica prima di un'operazione di eliminazione.
Filtering	Si verifica prima di un'operazione di filtro.
Inserted	Si verifica quando viene completata un'operazione di inserimento.
Inserting	Si verifica prima di un'operazione di inserimento.
Selected	Si verifica quando viene completata un'operazione di recupero.
Selecting	Si verifica prima di un'operazione di recupero dati.
Updated	Si verifica quando viene completata un'operazione di aggiornamento.
Updating	Si verifica prima di un'operazione di aggiornamento.

Implementazioni dell'interfaccia esplicita

IStateManager.IsTrackingViewState	Per una descrizione di questo membro, vedere IsTrackingViewState.
IStateManager.LoadViewState(Object)	Per una descrizione di questo membro, vedere LoadViewState(Object).
IStateManager.SaveViewState()	Per una descrizione di questo membro, vedere SaveViewState().
IStateManager.TrackViewState()	Per una descrizione di questo membro, vedere TrackViewState().

Si applica a

Condividi tramite