SqlDataSourceView Classe

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Prend en charge le SqlDataSource contrôle et fournit une interface pour les contrôles liés aux données afin d’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: Object

DataSourceView
SqlDataSourceView

Dérivé: System.Web.UI.WebControls.AccessDataSourceView

Implémente: IStateManager

Remarques

La SqlDataSourceView classe est destinée principalement à ê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 il est associé et implémente les fonctionnalités de base des données pour le contrôle de source de données. La SqlDataSourceView classe implémente les fonctionnalités de données du SqlDataSource contrôle, notamment les opérations, Update Insert Delete le Selecttri, le filtrage et la gestion des paramètres 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, la plupart de ses propriétés 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 à partir de la base de données sous-jacente à l’aide de la Select méthode, qui récupère une IEnumerable collection d’éléments 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 une plus grande flexibilité et une sécurité accrues. Les méthodes, propriétés et événements de récupération de données suivantes sont implémentées par le SqlDataSourceView contrôle et exposés directement par son SqlDataSource contrôle aux développeurs de pages et à d’autres appelants :

La propriété SelectCommand
La propriété SelectParameters
L’événement Selecting
L’événement Selected

L’objet prend en charge la SqlDataSourceView 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 une plus grande flexibilité et une sécurité accrues. Les contrôles liés aux données, tels que le GridView et DetailsView, peuvent être configurés pour effectuer des mises à jour automatiquement à l’aide du SqlDataSourceViewcontrôle , tandis que d’autres contrôles ne peuvent pas. Les méthodes de mise à jour, les propriétés et les événements suivants sont implémentés par le SqlDataSourceView contrôle et exposés directement par son SqlDataSource contrôle aux développeurs de pages et à d’autres appelants :

La propriété UpdateCommand
La propriété UpdateParameters
L’événement Updating
L’événement Updated

Il SqlDataSourceView prend 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 une plus grande flexibilité et une sécurité accrues. Les contrôles liés aux données, tels que le GridView et DetailsView, peuvent être configurés pour effectuer des insertions automatiquement à l’aide du SqlDataSourceViewcontrôle , tandis que d’autres contrôles ne peuvent pas. Les méthodes d’insertion, les propriétés et les événements suivants sont implémentées par le SqlDataSourceView contrôle et exposés directement par son SqlDataSource contrôle aux développeurs de pages et à d’autres appelants :

La propriété InsertCommand
La propriété InsertParameters
L’événement Inserting
L’événement Inserted

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

La propriété DeleteCommand
La propriété DeleteParameters
L’événement Deleting
L’événement Deleted

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é sur chaque chargement de page, vous pouvez utiliser les propriétés et FilterParameters les FilterExpression propriétés pour appliquer le filtrage dynamique à la récupération des données. Ces propriétés sont implémentées par le SqlDataSourceView contrôle et 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 entraîne l’exécution de l’ordre de la base de données 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 à l’objet SqlDataSourceView en 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 des contrôles concurrentiels via la SqlDataSource.ConflictDetection propriété. La fonctionnalité est implémentée dans la SqlDataSourceView.ConflictDetection propriété.

Comme beaucoup d’autres contrôles de serveur web, l’interface SqlDataSourceView implémente et utilise l’état IStateManager d’affichage pour suivre son état sur les demandes de page. Les implémentations de la propriété et de la IsTrackingViewState LoadViewStatepropriété SaveViewState, et des méthodes sont TrackViewState 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

Nom	Description
SqlDataSourceView(SqlDataSource, String, HttpContext)	Initialise une nouvelle instance de la SqlDataSourceView classe définissant le contrôle spécifié SqlDataSource en tant que propriétaire de l’affichage actuel.

Propriétés

Nom	Description
CancelSelectOnNullParameter	Obtient ou définit une valeur indiquant si une opération de récupération de données est annulée quand un paramètre contenu dans la SelectParameters collection est évalué à `null`.
CanDelete	Obtient une valeur indiquant si l’objet SqlDataSourceView associé au contrôle actuel SqlDataSource prend en charge l’opération de suppression.
CanInsert	Obtient une valeur indiquant si l’objet SqlDataSourceView associé au contrôle actuel SqlDataSource prend en charge l’opération d’insertion.
CanPage	Obtient une valeur indiquant si l’objet SqlDataSourceView associé au contrôle actuel SqlDataSource prend en charge la pagination des données récupérées.
CanRetrieveTotalRowCount	Obtient une valeur indiquant si l’objet SqlDataSourceView associé au contrôle actuel SqlDataSource prend en charge la récupération du nombre total de lignes de données, en plus du jeu de données.
CanSort	Obtient une valeur indiquant si l’objet SqlDataSourceView associé au contrôle actuel SqlDataSource prend en charge une vue triée sur les données récupérées.
CanUpdate	Obtient une valeur indiquant si l’objet SqlDataSourceView associé au contrôle actuel SqlDataSource prend en charge l’opération de mise à jour.
ConflictDetection	Obtient ou définit la valeur indiquant comment le SqlDataSource contrôle effectue des mises à jour et supprime lorsque les données d’une ligne dans la base de données sous-jacente changent pendant le temps de l’opération.
DeleteCommand	Obtient ou définit la chaîne SQL utilisée SqlDataSourceView 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 DeleteCommand propriété est une instruction SQL ou le nom d’une procédure stockée.
DeleteParameters	Obtient la collection de paramètres contenant les paramètres utilisés par la DeleteCommand propriété.
Events	Obtient une liste de délégués de gestionnaire d’événements pour la vue de source de données. (Hérité de DataSourceView)
FilterExpression	Obtient ou définit une expression de filtrage appliquée lorsque la Select méthode est appelée.
FilterParameters	Obtient une collection de paramètres associés à tous les espaces réservés de paramètres dans la FilterExpression chaîne.
InsertCommand	Obtient ou définit la chaîne SQL utilisée par l’objet SqlDataSourceView 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 InsertCommand propriété est une instruction SQL ou le nom d’une procédure stockée.
InsertParameters	Obtient la collection de paramètres contenant les paramètres utilisés par la InsertCommand propriété.
IsTrackingViewState	Obtient une valeur indiquant si l’objet SqlDataSourceView enregistre les modifications apportées à son état d’affichage.
Name	Obtient le nom de la vue de source de données. (Hérité de DataSourceView)
OldValuesParameterFormatString	Obtient ou définit une chaîne de format à appliquer aux noms des paramètres passés à la ou Update à la Delete méthode.
ParameterPrefix	Obtient la chaîne utilisée pour préfixer un espace réservé de paramètre dans une requête SQL paramétrable.
SelectCommand	Obtient ou définit la chaîne SQL utilisée par l’objet SqlDataSourceView 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 SelectCommand propriété 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 utilisés par la SelectCommand propriété.
SortParameterName	Obtient ou définit le nom d’un paramètre de procédure stockée utilisé pour trier les données récupérées lorsque la récupération des données est effectuée à l’aide d’une procédure stockée.
UpdateCommand	Obtient ou définit la chaîne SQL utilisée par l’objet SqlDataSourceView pour mettre à jour les données dans la base de données sous-jacente.
UpdateCommandType	Obtient ou définit une valeur indiquant si le texte de la UpdateCommand propriété est une instruction SQL ou le nom d’une procédure stockée.
UpdateParameters	Obtient la collection de paramètres contenant les paramètres utilisés par la UpdateCommand propriété.

Méthodes

Nom	Description
CanExecute(String)	Détermine si la commande spécifiée peut être exécutée. (Hérité de DataSourceView)
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Effectue 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)	Effectue une opération de suppression à l’aide de la DeleteCommand chaîne SQL, des paramètres spécifiés dans la DeleteParameters collection et des valeurs figurant dans les collections et spécifiées `keysoldValues` .
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)	Effectue une opération de suppression à l’aide de la DeleteCommand chaîne SQL, des paramètres spécifiés dans la DeleteParameters collection et des valeurs figurant dans les collections et spécifiées `keysoldValues` .
ExecuteInsert(IDictionary)	Effectue une opération d’insertion à l’aide de la InsertCommand chaîne SQL, de tous les paramètres spécifiés dans la InsertParameters collection et des valeurs qui se trouvent dans la collection spécifiée `values` .
ExecuteSelect(DataSourceSelectArguments)	Récupère les données de la base de données sous-jacente à l’aide de la SelectCommand chaîne SQL et de tous les paramètres qui se trouvent dans la SelectParameters collection.
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Effectue une opération de mise à jour à l’aide de la UpdateCommand chaîne SQL, de tous les paramètres qui se trouvent dans la UpdateParameters collection et des valeurs qui se trouvent dans les collections et les collections spécifiés`valueskeysoldValues`.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
Insert(IDictionary, DataSourceViewOperationCallback)	Effectue une opération d’insertion asynchrone sur la liste des données que l’objet DataSourceView représente. (Hérité de DataSourceView)
Insert(IDictionary)	Effectue une opération d’insertion à l’aide de la InsertCommand chaîne SQL, de tous les paramètres spécifiés dans la InsertParameters collection et des valeurs qui se trouvent dans la collection spécifiée `values` .
LoadViewState(Object)	Restaure l’état d’affichage précédemment enregistré pour la vue de source de données.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnDataSourceViewChanged(EventArgs)	Déclenche l’événement DataSourceViewChanged. (Hérité de DataSourceView)
OnDeleted(SqlDataSourceStatusEventArgs)	Déclenche l’événement Deleted une fois que le SqlDataSource contrôle a terminé une opération de suppression.
OnDeleting(SqlDataSourceCommandEventArgs)	Déclenche l’événement Deleting avant que le SqlDataSource contrôle tente d’effectuer une opération de suppression.
OnFiltering(SqlDataSourceFilteringEventArgs)	Déclenche l’événement Filtering avant que le SqlDataSource contrôle filtre les résultats d’une opération de sélection.
OnInserted(SqlDataSourceStatusEventArgs)	Déclenche l’événement Inserted une fois que le SqlDataSource contrôle a terminé une opération d’insertion.
OnInserting(SqlDataSourceCommandEventArgs)	Déclenche l’événement Inserting avant que le SqlDataSource contrôle tente une opération d’insertion.
OnSelected(SqlDataSourceStatusEventArgs)	Déclenche l’événement Selected une fois que le SqlDataSource contrôle a terminé une opération de récupération de données.
OnSelecting(SqlDataSourceSelectingEventArgs)	Déclenche l’événement Selecting avant que le SqlDataSource contrôle tente d’effectuer une opération de récupération de données.
OnUpdated(SqlDataSourceStatusEventArgs)	Déclenche l’événement Updated une fois que le SqlDataSource contrôle a terminé une opération de mise à jour.
OnUpdating(SqlDataSourceCommandEventArgs)	Déclenche l’événement Updating avant que le SqlDataSource contrôle tente une opération de mise à jour.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Compare les fonctionnalités demandées pour une ExecuteSelect(DataSourceSelectArguments) opération par rapport à celles prises en charge par la vue et appelées par la RaiseUnsupportedCapabilitiesError(DataSourceView) méthode.
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 de manière asynchrone à partir du stockage de données sous-jacent. (Hérité de DataSourceView)
Select(DataSourceSelectArguments)	Récupère les données de la base de données sous-jacente à l’aide de la SelectCommand chaîne SQL et de tous les paramètres qui se trouvent dans la SelectParameters collection.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)
TrackViewState()	Provoque le SqlDataSourceView suivi des modifications apportées à son état d’affichage afin que les modifications puissent être stockées dans l’objet pour le StateBag contrôle et conservées dans les demandes de la même page.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Effectue une opération de mise à jour asynchrone sur la liste des données que l’objet DataSourceView représente. (Hérité de DataSourceView)
Update(IDictionary, IDictionary, IDictionary)	Effectue une opération de mise à jour à l’aide de la UpdateCommand chaîne SQL, de tous les paramètres qui se trouvent dans la UpdateParameters collection et des valeurs qui se trouvent dans les collections et les collections spécifiés`valueskeysoldValues`.

Événements

Nom	Description
DataSourceViewChanged	Se produit lorsque la vue de source de données a changé. (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

Nom	Description
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

Commentaires

Est-ce que cette page vous a été utile?