SqlDataSourceView Classe

Définition

Prend en charge le contrôle SqlDataSource et fournit une interface pour les contrôles liés aux données pour effectuer des opérations de données SQL sur des bases de données relationnelles.

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
Héritage
SqlDataSourceView
Dérivé
Implémente

Remarques

La SqlDataSourceView classe est principalement destinée à être utilisée par les contrôles liés aux données, et non en tant qu’objet programmable dans le code de page.

ASP.NET contrôles de source de données contiennent une ou plusieurs listes de données, représentées par des objets de vue de source de données. La SqlDataSourceView classe étend la DataSourceView classe, définit les fonctionnalités du SqlDataSource contrôle auquel elle est associée et implémente les fonctionnalités de données de base pour le contrôle de source de données. La SqlDataSourceView classe implémente les fonctionnalités de données pour le SqlDataSource contrôle, y compris les Selectopérations , Update, Insertet , le Delete tri, le filtrage et la gestion des paramètres qui sont conservés dans l’état d’affichage.

Bien que l’objet SqlDataSourceView ne soit pas directement exposé aux développeurs de pages par le SqlDataSource contrôle, plusieurs de ses propriétés le sont. L’opération la plus simple effectuée par une vue de source de données est la récupération des données de la base de données sous-jacente à l’aide de la Select méthode , qui récupère une collection d’éléments IEnumerable de données. La SqlDataSourceView classe implémente la récupération des données à partir de bases de données relationnelles à l’aide de requêtes SQL. Les requêtes SQL peuvent être paramétrées pour plus de flexibilité et de sécurité. Les méthodes, propriétés et événements de récupération de données suivants sont implémentés par le SqlDataSourceView et exposés directement par son SqlDataSource contrôle aux développeurs de pages et autres appelants :

L’objet SqlDataSourceView prend en charge la mise à jour des données dans une base de données relationnelle à l’aide de commandes SQL. Les commandes SQL peuvent être paramétrées pour plus de flexibilité et de sécurité. Les contrôles liés aux données, tels que et GridViewDetailsView, peuvent être configurés pour effectuer des mises à jour automatiquement à l’aide de SqlDataSourceView, alors que d’autres contrôles ne le peuvent pas. Les méthodes de mise à jour, les propriétés et les événements suivants sont implémentés par le SqlDataSourceView et exposés directement par son SqlDataSource contrôle aux développeurs de pages et aux autres appelants :

Prend SqlDataSourceView en charge l’insertion de nouvelles lignes de données dans une base de données relationnelle. Les commandes SQL spécifiées dans la InsertCommand propriété peuvent être paramétrées pour plus de flexibilité et de sécurité. Les contrôles liés aux données, tels que et GridViewDetailsView, peuvent être configurés pour effectuer des insertions automatiquement à l’aide de SqlDataSourceView, alors que d’autres contrôles ne le peuvent pas. Les méthodes, propriétés et événements d’insertion suivants sont implémentés par le SqlDataSourceView et exposés directement par son SqlDataSource contrôle aux développeurs de pages et autres appelants :

L’objet SqlDataSourceView prend également en charge la suppression de données d’une base de données relationnelle. Comme avec les autres commandes, les commandes SQL spécifiées dans la DeleteCommand propriété peuvent être paramétrées pour plus de flexibilité et de sécurité. Les contrôles liés aux données, tels que et GridViewDetailsView, peuvent être configurés pour effectuer des suppressions automatiquement à l’aide de , SqlDataSourceViewalors que d’autres contrôles ne le peuvent pas. Les méthodes, propriétés et événements de suppression suivants sont implémentés par le SqlDataSourceView et exposés directement par son SqlDataSource contrôle aux développeurs de pages et aux autres appelants :

La récupération de données est plus puissante lorsque la clause utilisée pour filtrer les données pendant la récupération des données est dynamique. En d’autres termes, une requête SQL avec une clause WHERE statique n’est pas aussi flexible et puissante qu’une requête SQL où les valeurs de la clause WHERE sont liées à des valeurs qui peuvent changer, telles que les valeurs affichées dans les contrôles d’une page Web Forms. Au lieu de reconstruire une requête SQL et de définir la SelectCommand propriété à chaque chargement de page, vous pouvez utiliser les propriétés et FilterParameters pour appliquer un filtrage dynamique à la FilterExpression récupération de données. Ces propriétés sont implémentées par et SqlDataSourceView exposées directement par son SqlDataSource contrôle aux contrôles liés aux données et à d’autres appelants.

Vous pouvez trier les données que vous récupérez avec le SqlDataSource contrôle en ajoutant une clause ORDER BY, ce qui permet à la base de données d’effectuer le classement pour vous lorsque vous récupérez des données ou en triant les données en mémoire une fois qu’elles ont été récupérées. Vous pouvez fournir une expression de tri à en SqlDataSourceView définissant la SortExpression propriété de l’objet DataSourceSelectArguments passé à la Select méthode . La syntaxe de la SortExpression propriété est identique à la syntaxe d’une DataView.Sort propriété. Si vous utilisez une procédure stockée pour récupérer des données, vous pouvez également utiliser la SortParameterName propriété pour spécifier un paramètre utilisé spécifiquement pour trier les résultats d’un appel de procédure stockée.

Lorsque plusieurs utilisateurs peuvent modifier la base de données simultanément, il existe un risque de conflit d’accès concurrentiel. Le SqlDataSource contrôle a la concurrence des contrôles via la SqlDataSource.ConflictDetection propriété . La fonctionnalité est implémentée dans la SqlDataSourceView.ConflictDetection propriété .

Comme de nombreux autres contrôles de serveur web, le SqlDataSourceView implémente l’interface et utilise l’état IStateManager d’affichage pour suivre son état sur les demandes de page. Les implémentations de la IsTrackingViewState propriété et et des LoadViewStateméthodes , SaveViewStateet TrackViewState sont fournies pour activer le suivi de l’état d’affichage pour le contrôle. Pour plus d’informations, consultez ASP.NET Vue d’ensemble de la gestion de l’état.

Constructeurs

SqlDataSourceView(SqlDataSource, String, HttpContext)

Initialise une nouvelle instance de la classe SqlDataSourceView définissant le contrôle SqlDataSource spécifié en tant que propriétaire de l'affichage actuel.

Propriétés

CancelSelectOnNullParameter

Obtient ou définit une valeur indiquant si une opération de récupération de données est annulée lorsque tout paramètre qui est contenu dans la collection SelectParameters est égal à null.

CanDelete

Obtient une valeur indiquant si l'objet SqlDataSourceView qui est associé au contrôle SqlDataSource en cours prend en charge l'opération de suppression.

CanInsert

Obtient une valeur indiquant si l'objet SqlDataSourceView qui est associé au contrôle SqlDataSource en cours prend en charge l'opération d'insertion.

CanPage

Obtient une valeur indiquant si l'objet SqlDataSourceView qui est associé au contrôle SqlDataSource en cours prend en charge la pagination de données récupérées.

CanRetrieveTotalRowCount

Obtient une valeur indiquant si l'objet SqlDataSourceView qui est associé au contrôle SqlDataSource en cours prend en charge la récupération du nombre total de lignes en plus du groupe de données.

CanSort

Obtient une valeur indiquant si l'objet SqlDataSourceView qui est associé au contrôle SqlDataSource en cours prend en charge une vue triée sur les données récupérées.

CanUpdate

Obtient une valeur indiquant si l'objet SqlDataSourceView qui est associé au contrôle SqlDataSource en cours prend en charge l'opération de mise à jour.

ConflictDetection

Obtient ou définit la valeur indiquant comment le contrôle SqlDataSource exécute des mises à jour et des suppressions lorsque des données dans une ligne de la base de données sous-jacente sont modifiées au cours de l'opération.

DeleteCommand

Obtient ou définit la chaîne SQL que SqlDataSourceView utilise pour supprimer des données de la base de données sous-jacente.

DeleteCommandType

Obtient ou définit une valeur indiquant si le texte de la propriété DeleteCommand est une instruction SQL ou le nom d'une procédure stockée.

DeleteParameters

Obtient la collection de paramètres contenant les paramètres qui sont utilisés par la propriété DeleteCommand.

Events

Obtient la liste des délégués de gestion d'événements pour l'affichage de source de données.

(Hérité de DataSourceView)
FilterExpression

Obtient ou définit une expression de filtrage appliquée lorsque la méthode Select est appelée.

FilterParameters

Obtient une collection de paramètres qui sont associés aux espaces réservés des paramètres dans la chaîne FilterExpression.

InsertCommand

Obtient ou définit la chaîne SQL que l'objet SqlDataSourceView utilise pour insérer des données dans la base de données sous-jacente.

InsertCommandType

Obtient ou définit une valeur indiquant si le texte de la propriété InsertCommand est une instruction SQL ou le nom d'une procédure stockée.

InsertParameters

Obtient la collection de paramètres contenant les paramètres qui sont utilisés par la propriété InsertCommand.

IsTrackingViewState

Obtient une valeur indiquant si l'objet SqlDataSourceView enregistre les modifications apportées à son état d'affichage.

Name

Obtient le nom de l'affichage de source de données.

(Hérité de DataSourceView)
OldValuesParameterFormatString

Obtient ou définit une chaîne de mise en forme à appliquer aux noms de tous les paramètres qui sont passés à la méthode Delete ou Update.

ParameterPrefix

Obtient la chaîne qui est utilisée pour préfixer un espace réservé de paramètre dans une requête SQL paramétrée.

SelectCommand

Obtient ou définit la chaîne SQL que l'objet SqlDataSourceView utilise pour récupérer des données de la base de données sous-jacente.

SelectCommandType

Obtient ou définit une valeur indiquant si le texte de la propriété SelectCommand est une requête SQL ou le nom d'une procédure stockée.

SelectParameters

Obtient la collection de paramètres contenant les paramètres qui sont utilisés par la propriété SelectCommand.

SortParameterName

Obtient ou définit le nom d'un paramètre de procédure stockée qui est utilisé pour trier des données récupérées lorsque la récupération de données est exécutée à l'aide d'une procédure stockée.

UpdateCommand

Obtient ou définit la chaîne SQL que l'objet SqlDataSourceView utilise pour mettre à jour des données de la base de données sous-jacente.

UpdateCommandType

Obtient ou définit une valeur indiquant si le texte de la propriété UpdateCommand est une instruction SQL ou le nom d'une procédure stockée.

UpdateParameters

Obtient la collection de paramètres contenant les paramètres qui sont utilisés par la propriété UpdateCommand.

Méthodes

CanExecute(String)

Détermine si la commande spécifiée peut être exécutée.

(Hérité de DataSourceView)
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)

Exécute une opération de suppression asynchrone sur la liste des données que l'objet DataSourceView représente.

(Hérité de DataSourceView)
Delete(IDictionary, IDictionary)

Exécute une opération de suppression à l'aide de la chaîne DeleteCommand SQL, de tout paramètre spécifié dans la collection DeleteParameters et des valeurs dans les keys et collections oldValues spécifiées.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)

Exécute la commande spécifiée.

(Hérité de DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary)

Exécute la commande spécifiée.

(Hérité de DataSourceView)
ExecuteDelete(IDictionary, IDictionary)

Exécute une opération de suppression à l'aide de la chaîne DeleteCommand SQL, de tout paramètre spécifié dans la collection DeleteParameters et des valeurs dans les keys et collections oldValues spécifiées.

ExecuteInsert(IDictionary)

Exécute une opération d'insertion à l'aide de la chaîne InsertCommand SQL, de tout paramètre spécifié dans la collection InsertParameters et des valeurs qui se trouvent dans la collection values spécifiée.

ExecuteSelect(DataSourceSelectArguments)

Récupère des données de la base de données sous-jacente à l'aide de la chaîne SQL SelectCommand et des paramètres de la collection SelectParameters.

ExecuteUpdate(IDictionary, IDictionary, IDictionary)

Exécute une opération de mise à jour à l'aide de la chaîne UpdateCommand SQL, tout paramètre de la collection UpdateParameters ainsi que les valeurs se trouvant dans les collections keys, values et oldValues spécifiées.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
Insert(IDictionary, DataSourceViewOperationCallback)

Exécute une opération d'insertion asynchrone dans la liste des données que l'objet DataSourceView représente.

(Hérité de DataSourceView)
Insert(IDictionary)

Exécute une opération d'insertion à l'aide de la chaîne InsertCommand SQL, de tout paramètre spécifié dans la collection InsertParameters et des valeurs qui se trouvent dans la collection values spécifiée.

LoadViewState(Object)

Restaure l'état d'affichage enregistré précédemment pour la vue de source de données.

MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
OnDataSourceViewChanged(EventArgs)

Déclenche l’événement DataSourceViewChanged.

(Hérité de DataSourceView)
OnDeleted(SqlDataSourceStatusEventArgs)

Déclenche l'événement Deleted après que le contrôle SqlDataSource a complété une opération de suppression.

OnDeleting(SqlDataSourceCommandEventArgs)

Déclenche l'événement Deleting avant que le contrôle SqlDataSource ne tente une opération de suppression.

OnFiltering(SqlDataSourceFilteringEventArgs)

Déclenche l'événement Filtering avant que le contrôle SqlDataSource ne filtre les résultats d'une opération de sélection.

OnInserted(SqlDataSourceStatusEventArgs)

Déclenche l'événement Inserted après que le contrôle SqlDataSource a terminé une opération d'insertion.

OnInserting(SqlDataSourceCommandEventArgs)

Déclenche l'événement Inserting avant que le contrôle SqlDataSource ne tente une opération d'insertion.

OnSelected(SqlDataSourceStatusEventArgs)

Déclenche l'événement Selected après que le contrôle SqlDataSource a complété une opération de récupération.

OnSelecting(SqlDataSourceSelectingEventArgs)

Déclenche l'événement Selecting avant que le contrôle SqlDataSource ne tente une opération de récupération.

OnUpdated(SqlDataSourceStatusEventArgs)

Déclenche l'événement Updated après que le contrôle SqlDataSource a terminé une opération de mise à jour.

OnUpdating(SqlDataSourceCommandEventArgs)

Déclenche l'événement Updating avant que le contrôle SqlDataSource ne tente une opération de mise à jour.

RaiseUnsupportedCapabilityError(DataSourceCapabilities)

Compare les fonctions demandées pour une opération ExecuteSelect(DataSourceSelectArguments) avec celles prises en charge par l'affichage et est appelé par la méthode RaiseUnsupportedCapabilitiesError(DataSourceView).

SaveViewState()

Enregistre les modifications apportées à l’état d’affichage du SqlDataSourceView contrôle depuis le moment où la page a été publiée sur le serveur.

Select(DataSourceSelectArguments, DataSourceViewSelectCallback)

Obtient une liste de données en mode asynchrone provenant du stockage des données sous-jacent.

(Hérité de DataSourceView)
Select(DataSourceSelectArguments)

Récupère des données de la base de données sous-jacente à l'aide de la chaîne SQL SelectCommand et des paramètres de la collection SelectParameters.

ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)
TrackViewState()

Ainsi, l'objet SqlDataSourceView effectue le suivi des modifications de son état d'affichage afin qu'elles puissent être stockées dans l'objet StateBag du contrôle et être persistantes entre les requêtes de la même page.

Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)

Exécute une opération de mise à jour asynchrone dans la liste des données que l'objet DataSourceView représente.

(Hérité de DataSourceView)
Update(IDictionary, IDictionary, IDictionary)

Exécute une opération de mise à jour à l'aide de la chaîne UpdateCommand SQL, tout paramètre de la collection UpdateParameters ainsi que les valeurs se trouvant dans les collections keys, values et oldValues spécifiées.

Événements

DataSourceViewChanged

Se produit lorsque l'affichage de source de données a été modifié.

(Hérité de DataSourceView)
Deleted

Se produit lorsqu'une opération de suppression est terminée.

Deleting

Se produit avant une opération de suppression.

Filtering

Se produit avant une opération de filtre.

Inserted

Se produit lorsqu'une opération d'insertion est terminée.

Inserting

Se produit avant une opération d'insertion.

Selected

Se produit lorsqu'une opération de récupération de données est terminée.

Selecting

Se produit avant une opération de récupération de données.

Updated

Se produit lorsqu'une opération de mise à jour est terminée.

Updating

Se produit avant une opération de mise à jour.

Implémentations d’interfaces explicites

IStateManager.IsTrackingViewState

Pour obtenir une description de ce membre, consultez IsTrackingViewState.

IStateManager.LoadViewState(Object)

Pour obtenir une description de ce membre, consultez LoadViewState(Object).

IStateManager.SaveViewState()

Pour obtenir une description de ce membre, consultez SaveViewState().

IStateManager.TrackViewState()

Pour obtenir une description de ce membre, consultez TrackViewState().

S’applique à

Voir aussi