SqlDataSourceView Classe

Definizione

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à
SqlDataSourceView
Derivato
Implementazioni

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 , , UpdateInserteDelete, l'ordinamento, il SqlDataSource filtro e la gestione delle impostazioni mantenute nello stato di visualizzazione.

Anche se l'oggetto SqlDataSourceViewSqlDataSource 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:

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

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 a dati, ad esempio GridView e DetailsView, possono essere configurati per eseguire automaticamente inserimenti tramite SqlDataSourceView, mentre altri controlli non possono. I metodi di inserimento, le proprietà e gli eventi seguenti vengono implementati da SqlDataSourceView e esposti direttamente dal SqlDataSource controllo agli sviluppatori di pagine e ad altri chiamanti:

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 a dati, ad esempio GridView e DetailsView, possono essere configurati per eseguire automaticamente le eliminazioni tramite SqlDataSourceView, mentre altri controlli non possono. I metodi di eliminazione, le proprietà e gli eventi seguenti vengono implementati da SqlDataSourceView e esposti direttamente dal SqlDataSource controllo agli sviluppatori di pagine e ad altri chiamanti:

Il recupero dei dati è più efficace 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 nella clausola WHERE sono associati a valori che possono cambiare, ad esempio i valori visualizzati nei controlli in una pagina di Web Forms. Anziché ricompilare una query SQL e impostare la SelectCommand proprietà in ogni caricamento di pagine, è possibile usare le FilterExpression proprietà e FilterParameters per applicare il filtro dinamico al recupero dei dati. Queste proprietà vengono implementate da SqlDataSourceView e esposte direttamente dal controllo SqlDataSource ai controlli associati a dati e ad altri chiamanti.

È possibile ordinare i dati recuperati con il SqlDataSource controllo aggiungendo una clausola ORDER BY, che fa sì che il database esegua l'ordinamento quando si recuperano i dati o ordinando i dati in memoria dopo il recupero. È possibile fornire un'espressione SqlDataSourceView di ordinamento a impostando 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 utilizza una stored procedure per recuperare i dati, è anche possibile utilizzare la SortParameterName proprietà per specificare un parametro utilizzato in modo specifico per l'ordinamento dei risultati di una chiamata di stored procedure.

Quando più utenti possono modificare il database contemporaneamente, si verifica un potenziale 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, implementa SqlDataSourceView l'interfaccia IStateManager e usa lo stato di visualizzazione per tenere traccia dello stato tra le richieste di pagina. Le implementazioni della IsTrackingViewState proprietà e e dei LoadViewStatemetodi , SaveViewStatee TrackViewState vengono fornite per abilitare il rilevamento dello stato di visualizzazione per il controllo . Per altre informazioni, vedere panoramica di gestione dello stato di ASP.NET.

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)

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.

Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)

Esegue un'operazione di eliminazione asincrona sull'elenco di dati rappresentato dall'oggetto DataSourceView.

(Ereditato da DataSourceView)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
ExecuteCommand(String, IDictionary, IDictionary)

Esegue il comando specificato.

(Ereditato da DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)

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)

Esegue un'operazione di inserimento utilizzando la stringa SQL InsertCommand, tutti i parametri specificati nell'insieme InsertParameters e i valori dell'insieme values specificato.

Insert(IDictionary, DataSourceViewOperationCallback)

Esegue un'operazione di inserimento asincrona sull'elenco di dati rappresentato dall'oggetto DataSourceView.

(Ereditato da DataSourceView)
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)

Recupera dati dal database sottostante utilizzando la stringa SQL SelectCommand e tutti i parametri dell'insieme SelectParameters.

Select(DataSourceSelectArguments, DataSourceViewSelectCallback)

Ottiene un elenco di dati dall'archivio dati sottostante in modo asincrono.

(Ereditato da DataSourceView)
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)

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.

Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)

Esegue un'operazione di aggiornamento asincrona sull'elenco di dati rappresentato dall'oggetto DataSourceView.

(Ereditato da DataSourceView)

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

Vedi anche