Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

SqlDataSource classe

 

Représente une base de données SQL pour les contrôles liés aux données.

Espace de noms:   System.Web.UI.WebControls
Assembly:  System.Web (dans System.Web.dll)

System.Object
  System.Web.UI.Control
    System.Web.UI.DataSourceControl
      System.Web.UI.WebControls.SqlDataSource
        System.Web.UI.WebControls.AccessDataSource

[ToolboxBitmapAttribute(typeof(SqlDataSource))]
public class SqlDataSource : DataSourceControl

NomDescription
System_CAPS_pubmethodSqlDataSource()

Initialise une nouvelle instance de la classe SqlDataSource.

System_CAPS_pubmethodSqlDataSource(String, String)

Initialise une nouvelle instance de la SqlDataSource classe avec la chaîne de connexion spécifiée et la commande Select.

System_CAPS_pubmethodSqlDataSource(String, String, String)

Initialise une nouvelle instance de la SqlDataSource classe avec la chaîne de connexion spécifiée et la commande Select.

NomDescription
System_CAPS_protpropertyAdapter

Obtient l’adaptateur spécifique au navigateur pour le contrôle.(Hérité de Control.)

System_CAPS_pubpropertyAppRelativeTemplateSourceDirectory

Obtient ou définit le répertoire virtuel relatif à l’application de la Page ou UserControl objet qui contient ce contrôle.(Hérité de Control.)

System_CAPS_pubpropertyBindingContainer

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient le contrôle qui contient la liaison de données de ce contrôle.(Hérité de Control.)

System_CAPS_pubpropertyCacheDuration

Obtient ou définit la durée, en secondes, que le contrôle de source de données met en cache les données récupérées par le Select (méthode).

System_CAPS_pubpropertyCacheExpirationPolicy

Obtient ou définit le comportement d’expiration du cache qui, lorsqu’elles sont combinées avec la durée, décrit le comportement du cache qui utilise le contrôle de source de données.

System_CAPS_pubpropertyCacheKeyDependency

Obtient ou définit une dépendance de clé définie par l’utilisateur qui est liée à toutes les données de cache des objets qui sont créés par le contrôle de source de données. Tous les objets du cache expirent explicitement lorsque la clé expire.

System_CAPS_pubpropertyCancelSelectOnNullParameter

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 le SelectParameters prend la valeur de collection null.

System_CAPS_protpropertyChildControlsCreated

Obtient une valeur qui indique si les contrôles enfants du contrôle serveur ont été créés.(Hérité de Control.)

System_CAPS_pubpropertyClientID

Obtient l’identificateur du contrôle serveur généré par ASP.NET.(Hérité de DataSourceControl.)

System_CAPS_pubpropertyClientIDMode

Cette propriété n’est pas utilisée pour les contrôles de source de données.(Hérité de DataSourceControl.)

System_CAPS_protpropertyClientIDSeparator

Obtient une valeur de caractère représentant le caractère de séparation utilisé dans le ClientID propriété.(Hérité de Control.)

System_CAPS_pubpropertyConflictDetection

Obtient ou définit la valeur indiquant comment la SqlDataSource contrôle effectue des mises à jour et des suppressions lorsque les données dans une ligne sous-jacente de base de données modifications pendant la durée de l’opération.

System_CAPS_pubpropertyConnectionString

Obtient ou définit la chaîne de connexion spécifique au fournisseur ADO.NET que le SqlDataSource contrôle utilise pour se connecter à une base de données sous-jacente.

System_CAPS_protpropertyContext

Obtient le HttpContext est associé au contrôle serveur pour la demande Web actuelle.(Hérité de Control.)

System_CAPS_pubpropertyControls

Obtient un objet ControlCollection qui représente les contrôles enfants pour un contrôle serveur spécifié dans la hiérarchie de l’interface utilisateur.(Hérité de DataSourceControl.)

System_CAPS_pubpropertyDataItemContainer

Obtient une référence au conteneur d’attribution de noms si celui-ci implémente IDataItemContainer.(Hérité de Control.)

System_CAPS_pubpropertyDataKeysContainer

Obtient une référence au conteneur d’attribution de noms si celui-ci implémente IDataKeysControl.(Hérité de Control.)

System_CAPS_pubpropertyDataSourceMode

Obtient ou définit le mode de récupération de données que le SqlDataSource contrôle utilise pour extraire des données.

System_CAPS_pubpropertyDeleteCommand

Obtient ou définit la chaîne SQL que le SqlDataSource contrôle utilise pour supprimer des données à partir de la base de données sous-jacente.

System_CAPS_pubpropertyDeleteCommandType

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

System_CAPS_pubpropertyDeleteParameters

Obtient la collection de paramètres qui contient les paramètres utilisés par le DeleteCommand propriété à partir de la SqlDataSourceView objet auquel est associé le SqlDataSource contrôle.

System_CAPS_protpropertyDesignMode

Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception.(Hérité de Control.)

System_CAPS_pubpropertyEnableCaching

Obtient ou définit une valeur indiquant si le SqlDataSource contrôle est mise en cache de données activée.

System_CAPS_pubpropertyEnableTheming

Obtient une valeur indiquant si ce contrôle prend en charge les thèmes.(Hérité de DataSourceControl.)

System_CAPS_pubpropertyEnableViewState

Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage, et l’état d’affichage de tous les contrôles enfants qu’il contient, au client demandeur.(Hérité de Control.)

System_CAPS_protpropertyEvents

Obtient une liste de délégués de gestionnaires d’événements pour le contrôle. Cette propriété est en lecture seule.(Hérité de Control.)

System_CAPS_pubpropertyFilterExpression

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

System_CAPS_pubpropertyFilterParameters

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

System_CAPS_protpropertyHasChildViewState

Obtient une valeur qui indique si les contrôles enfants du contrôle serveur actuel ont tous les paramètres d’état d’affichage enregistrés.(Hérité de Control.)

System_CAPS_pubpropertyID

Obtient ou définit l’identificateur programmatique assigné au contrôle serveur.(Hérité de Control.)

System_CAPS_protpropertyIdSeparator

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient le caractère utilisé pour séparer les identificateurs de contrôle.(Hérité de Control.)

System_CAPS_pubpropertyInsertCommand

Obtient ou définit la chaîne SQL que le SqlDataSource contrôle utilise pour insérer des données dans la base de données sous-jacente.

System_CAPS_pubpropertyInsertCommandType

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

System_CAPS_pubpropertyInsertParameters

Obtient la collection de paramètres qui contient les paramètres utilisés par le InsertCommand propriété à partir de la SqlDataSourceView objet auquel est associé le SqlDataSource contrôle.

System_CAPS_protpropertyIsChildControlStateCleared

Obtient une valeur qui indique si les contrôles contenus dans ce contrôle ont état du contrôle.(Hérité de Control.)

System_CAPS_protpropertyIsTrackingViewState

Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d’affichage.(Hérité de Control.)

System_CAPS_protpropertyIsViewStateEnabled

Obtient une valeur indiquant si l’état d’affichage est activé pour ce contrôle.(Hérité de Control.)

System_CAPS_protpropertyLoadViewStateByID

Obtient une valeur indiquant si le contrôle participe au chargement de son état d’affichage par ID au lieu de l’index.(Hérité de Control.)

System_CAPS_pubpropertyNamingContainer

Obtient une référence au contrôle de serveur de noms de conteneur, ce qui crée un espace de noms unique pour différencier les contrôles serveur avec le même Control.ID valeur de propriété.(Hérité de Control.)

System_CAPS_pubpropertyOldValuesParameterFormatString

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

System_CAPS_pubpropertyPage

Obtient une référence à la Page instance qui contient le contrôle serveur.(Hérité de Control.)

System_CAPS_pubpropertyParent

Obtient une référence au contrôle parent du contrôle de serveur dans la hiérarchie de contrôle de page.(Hérité de Control.)

System_CAPS_pubpropertyProviderName

Obtient ou définit le nom du fournisseur de données .NET Framework que le SqlDataSource contrôle utilise pour se connecter à une source de données sous-jacente.

System_CAPS_pubpropertyRenderingCompatibility

Obtient une valeur qui spécifie la version ASP.NET HTML restitué sera compatible avec.(Hérité de Control.)

System_CAPS_pubpropertySelectCommand

Obtient ou définit la chaîne SQL que le SqlDataSource contrôle utilise pour récupérer des données à partir de la base de données sous-jacente.

System_CAPS_pubpropertySelectCommandType

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

System_CAPS_pubpropertySelectParameters

Obtient la collection de paramètres qui contient les paramètres utilisés par le SelectCommand propriété à partir de la SqlDataSourceView objet auquel est associé le SqlDataSource contrôle.

System_CAPS_pubpropertySite

Obtient des informations sur le conteneur qui héberge le contrôle actuel lors du rendu sur une aire de conception.(Hérité de Control.)

System_CAPS_pubpropertySkinID

Obtient l’apparence à appliquer à la DataSourceControl contrôle.(Hérité de DataSourceControl.)

System_CAPS_pubpropertySortParameterName

Obtient ou définit le nom d’un paramètre de procédure stockée qui est utilisé pour trier les données récupérées lors de la récupération de données est effectuée à l’aide d’une procédure stockée.

System_CAPS_pubpropertySqlCacheDependency

Obtient ou définit une chaîne délimitée par des points-virgules qui indique les bases de données et les tables à utiliser pour la dépendance de cache Microsoft SQL Server.

System_CAPS_pubpropertyTemplateControl

Obtient ou définit une référence au modèle qui contient ce contrôle.(Hérité de Control.)

System_CAPS_pubpropertyTemplateSourceDirectory

Obtient le répertoire virtuel de le Page ou UserControl qui contient le contrôle serveur en cours.(Hérité de Control.)

System_CAPS_pubpropertyUniqueID

Obtient l’identificateur unique qualifié hiérarchiquement du contrôle serveur.(Hérité de Control.)

System_CAPS_pubpropertyUpdateCommand

Obtient ou définit la chaîne SQL que le SqlDataSource contrôle utilise pour mettre à jour les données dans la base de données sous-jacente.

System_CAPS_pubpropertyUpdateCommandType

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

System_CAPS_pubpropertyUpdateParameters

Obtient la collection de paramètres qui contient les paramètres utilisés par le UpdateCommand propriété à partir de la SqlDataSourceView auquel est associée la SqlDataSource contrôle.

System_CAPS_pubpropertyValidateRequestMode

Obtient ou définit une valeur qui indique si le contrôle vérifie les entrées de client à partir du navigateur de valeurs potentiellement dangereuses.(Hérité de Control.)

System_CAPS_protpropertyViewState

Obtient un dictionnaire d’informations d’état qui vous permet d’enregistrer et restaurer l’état d’affichage d’un contrôle serveur entre plusieurs demandes de la même page.(Hérité de Control.)

System_CAPS_protpropertyViewStateIgnoresCase

Obtient une valeur qui indique si le StateBag objet respecte la casse.(Hérité de Control.)

System_CAPS_pubpropertyViewStateMode

Obtient ou définit le mode d’état d’affichage de ce contrôle.(Hérité de Control.)

System_CAPS_pubpropertyVisible

Obtient ou définit une valeur indiquant si le contrôle est affiché visuellement.(Hérité de DataSourceControl.)

NomDescription
System_CAPS_protmethodAddedControl(Control, Int32)

Appelée après qu’un contrôle enfant est ajouté à la Controls collection de le Control objet.(Hérité de Control.)

System_CAPS_protmethodAddParsedSubObject(Object)

Notifie au contrôle serveur qu’un élément XML ou HTML a été analysé, et ajoute l’élément à l’objet ControlCollection du contrôle serveur.(Hérité de Control.)

System_CAPS_pubmethodApplyStyleSheetSkin(Page)

Applique les propriétés de style qui sont définies dans la feuille de style de page pour le contrôle.(Hérité de DataSourceControl.)

System_CAPS_protmethodBeginRenderTracing(TextWriter, Object)

Commence le suivi au moment du design de données de rendu.(Hérité de Control.)

System_CAPS_protmethodBuildProfileTree(String, Boolean)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Rassemble des informations sur le contrôle serveur, puis les remet à la Trace propriété à afficher lorsque le traçage est activé pour la page.(Hérité de Control.)

System_CAPS_protmethodClearCachedClientID()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Définit la mise en cache ClientID valeur null.(Hérité de Control.)

System_CAPS_protmethodClearChildControlState()

Supprime les informations d’état du contrôle pour les contrôles enfants du contrôle serveur.(Hérité de Control.)

System_CAPS_protmethodClearChildState()

Supprime les informations d’état d’affichage et état du contrôle pour tous les contrôles du contrôle serveur enfant.(Hérité de Control.)

System_CAPS_protmethodClearChildViewState()

Supprime les informations d’état d’affichage pour tous les contrôles du contrôle serveur enfant.(Hérité de Control.)

System_CAPS_protmethodClearEffectiveClientIDMode()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Définit le ClientIDMode propriété de l’instance actuelle du contrôle et de ses contrôles enfants à Inherit.(Hérité de Control.)

System_CAPS_protmethodCreateChildControls()

Appelée par l’infrastructure de page ASP.NET pour signaler aux contrôles serveur qu’ils doivent utiliser l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en vue de la publication ou du rendu.(Hérité de Control.)

System_CAPS_protmethodCreateControlCollection()

Crée une collection pour stocker des contrôles enfants.(Hérité de DataSourceControl.)

System_CAPS_protmethodCreateDataSourceView(String)

Crée un objet de vue de source de données qui est associé au contrôle de source de données.

System_CAPS_pubmethodDataBind()

Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants.(Hérité de Control.)

System_CAPS_protmethodDataBind(Boolean)

Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher la DataBinding événement.(Hérité de Control.)

System_CAPS_protmethodDataBindChildren()

Lie une source de données à des contrôles enfants du contrôle serveur.(Hérité de Control.)

System_CAPS_pubmethodDelete()

Effectue une opération de suppression à l’aide de la DeleteCommand chaîne SQL et tous les paramètres qui se trouvent dans le DeleteParameters collection.

System_CAPS_pubmethodDispose()

Permet à un contrôle serveur effectuer de nettoyage final avant qu’il est libéré de la mémoire.(Hérité de Control.)

System_CAPS_protmethodEndRenderTracing(TextWriter, Object)

Se termine au moment du design le suivi des données de rendu.(Hérité de Control.)

System_CAPS_protmethodEnsureChildControls()

Détermine si le contrôle serveur contient des contrôles enfants. Si elle n’est pas le cas, il crée contrôles enfants.(Hérité de Control.)

System_CAPS_protmethodEnsureID()

Crée un identificateur pour les contrôles qui n’ont pas d’identificateur affecté.(Hérité de Control.)

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodFindControl(String)

Recherche le conteneur d’attribution de noms actuel d’un contrôle serveur avec l’objet id paramètre.(Hérité de DataSourceControl.)

System_CAPS_protmethodFindControl(String, Int32)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Recherche le conteneur d’attribution de noms actuel d’un contrôle serveur avec l’objet id et un entier, spécifié dans le pathOffset paramètre, ce qui facilite la recherche. Vous ne devez pas substituer cette version de la FindControl méthode.(Hérité de Control.)

System_CAPS_pubmethodFocus()

Définit le focus d'entrée sur le contrôle.(Hérité de DataSourceControl.)

System_CAPS_protmethodGetDbProviderFactory()

Retourne le DbProviderFactory objet qui est associé au fournisseur ADO.NET identifié par la ProviderName propriété.

System_CAPS_protmethodGetDesignModeState()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient les données au moment du design pour un contrôle.(Hérité de Control.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetRouteUrl(Object)

Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire.(Hérité de Control.)

System_CAPS_pubmethodGetRouteUrl(RouteValueDictionary)

Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire.(Hérité de Control.)

System_CAPS_pubmethodGetRouteUrl(String, Object)

Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et un nom d’itinéraire.(Hérité de Control.)

System_CAPS_pubmethodGetRouteUrl(String, RouteValueDictionary)

Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et un nom d’itinéraire.(Hérité de Control.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodGetUniqueIDRelativeTo(Control)

Retourne la partie préfixée de la UniqueID propriété du contrôle spécifié.(Hérité de Control.)

System_CAPS_protmethodGetView(String)

Obtient la vue de source de données nommée qui est associée au contrôle de source de données.(Remplace DataSourceControl.GetView(String).)

System_CAPS_protmethodGetViewNames()

Obtient une collection de noms représentant la liste des objets de vue qui sont associés les SqlDataSource contrôle.(Remplace DataSourceControl.GetViewNames().)

System_CAPS_pubmethodHasControls()

Détermine si le contrôle serveur contient des contrôles enfants.(Hérité de DataSourceControl.)

System_CAPS_protmethodHasEvents()

Retourne une valeur indiquant si les événements sont inscrits pour le contrôle ou tous les contrôles enfants.(Hérité de Control.)

System_CAPS_pubmethodInsert()

Effectue une opération d’insertion à l’aide du InsertCommand chaîne SQL et tous les paramètres qui se trouvent dans le InsertParameters collection.

System_CAPS_protmethodIsLiteralContent()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Détermine si le contrôle serveur détient uniquement un contenu littéral.(Hérité de Control.)

System_CAPS_protmethodLoadControlState(Object)

Restaure les informations d’état du contrôle à partir d’une demande de page précédente enregistrée par la SaveControlState méthode.(Hérité de Control.)

System_CAPS_protmethodLoadViewState(Object)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Charge l'état des propriétés du contrôle SqlDataSource qui doivent être persistants.(Remplace Control.LoadViewState(Object).)

System_CAPS_protmethodMapPathSecure(String)

Récupère le chemin d’accès physique correspondant à un chemin d’accès virtuel, absolu ou relatif.(Hérité de Control.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_protmethodOnBubbleEvent(Object, EventArgs)

Détermine si l’événement du contrôle serveur est passé dans la hiérarchie des contrôles serveur de l’interface utilisateur de la page.(Hérité de Control.)

System_CAPS_protmethodOnDataBinding(EventArgs)

Déclenche l'événement DataBinding.(Hérité de Control.)

System_CAPS_protmethodOnInit(EventArgs)

Ajoute un LoadComplete Gestionnaire d’événements à le Page contrôle contenant le SqlDataSource contrôle.(Remplace Control.OnInit(EventArgs).)

System_CAPS_protmethodOnLoad(EventArgs)

Déclenche l'événement Load.(Hérité de Control.)

System_CAPS_protmethodOnPreRender(EventArgs)

Déclenche l'événement PreRender.(Hérité de Control.)

System_CAPS_protmethodOnUnload(EventArgs)

Déclenche l'événement Unload.(Hérité de Control.)

System_CAPS_protmethodOpenFile(String)

Obtient un Stream utilisé pour lire un fichier.(Hérité de Control.)

System_CAPS_protmethodRaiseBubbleEvent(Object, EventArgs)

Assigne toute source de l’événement et ses informations au parent du contrôle.(Hérité de Control.)

System_CAPS_protmethodRaiseDataSourceChangedEvent(EventArgs)

Déclenche l'événement DataSourceChanged.(Hérité de DataSourceControl.)

System_CAPS_protmethodRemovedControl(Control)

Appelée après qu’un contrôle enfant est supprimé de la Controls collection de le Control objet.(Hérité de Control.)

System_CAPS_protmethodRender(HtmlTextWriter)

Envoie le contenu du contrôle serveur à un objet HtmlTextWriter, qui écrit le contenu à rendre sur le client.(Hérité de Control.)

System_CAPS_protmethodRenderChildren(HtmlTextWriter)

Renvoie le contenu des enfants d’un contrôle serveur à une collection HtmlTextWriter objet, qui écrit le contenu à rendre sur le client.(Hérité de Control.)

System_CAPS_pubmethodRenderControl(HtmlTextWriter)

Renvoie le contenu du contrôle serveur à un HtmlTextWriter de l’objet et stocke les informations de traçage sur le contrôle si le traçage est activé.(Hérité de DataSourceControl.)

System_CAPS_protmethodRenderControl(HtmlTextWriter, ControlAdapter)

Renvoie le contenu du contrôle serveur à un HtmlTextWriter à l’aide d’un ControlAdapter objet.(Hérité de Control.)

System_CAPS_protmethodResolveAdapter()

Obtient l’adaptateur de contrôles responsable du rendu du contrôle spécifié.(Hérité de Control.)

System_CAPS_pubmethodResolveClientUrl(String)

Obtient une URL qui peut être utilisée par le navigateur.(Hérité de Control.)

System_CAPS_pubmethodResolveUrl(String)

Convertit une URL qui est utilisable sur le client demandeur.(Hérité de Control.)

System_CAPS_protmethodSaveControlState()

Enregistre tous les changements d’état de contrôle serveur qui ont eu lieu depuis que la page a été publiée sur le serveur.(Hérité de Control.)

System_CAPS_protmethodSaveViewState()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Enregistre l'état d'affichage actuel du SqlDataSource contrôle.(Remplace Control.SaveViewState().)

System_CAPS_pubmethodSelect(DataSourceSelectArguments)

Récupère des données à partir de la base de données sous-jacente en utilisant le SelectCommand chaîne SQL et tous les paramètres qui se trouvent dans le SelectParameters collection.

System_CAPS_protmethodSetDesignModeState(IDictionary)

Définit les données au moment du design pour un contrôle.(Hérité de Control.)

System_CAPS_pubmethodSetRenderMethodDelegate(RenderMethod)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Assigne un délégué de gestionnaire d’événements pour afficher le contrôle de serveur et son contenu dans son contrôle parent.(Hérité de Control.)

System_CAPS_pubmethodSetTraceData(Object, Object)

Définit les données de conception suivi de données de rendu, à l’aide de la clé de données de suivi et la valeur de données de suivi de trace.(Hérité de Control.)

System_CAPS_pubmethodSetTraceData(Object, Object, Object)

Définit les données de conception suivi de données de rendu, à l’aide de l’objet de suivi, la clé de données de suivi et la valeur de données de suivi de trace.(Hérité de Control.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodTrackViewState()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Suit les modifications d’état d’affichage du SqlDataSource contrôle afin que les modifications puissent être stockées dans le System.Web.UI.StateBag objet pour le contrôle.(Remplace Control.TrackViewState().)

System_CAPS_pubmethodUpdate()

Effectue une opération de mise à jour à l’aide de la UpdateCommand chaîne SQL et tous les paramètres qui se trouvent dans le UpdateParameters collection.

NomDescription
System_CAPS_pubeventDataBinding

Se produit lorsque le contrôle serveur se lie à une source de données.(Hérité de Control.)

System_CAPS_pubeventDeleted

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

System_CAPS_pubeventDeleting

Se produit avant une opération de suppression.

System_CAPS_pubeventDisposed

Se produit lorsqu’un contrôle serveur est libéré de la mémoire, ce qui constitue la dernière étape du cycle de vie serveur contrôle lorsqu’une page ASP.NET est demandée.(Hérité de Control.)

System_CAPS_pubeventFiltering

Se produit avant une opération de filtre.

System_CAPS_pubeventInit

Se produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape du cycle de vie.(Hérité de Control.)

System_CAPS_pubeventInserted

Se produit lorsqu’une opération d’insertion.

System_CAPS_pubeventInserting

Se produit avant une opération d’insertion.

System_CAPS_pubeventLoad

Se produit lorsque le contrôle serveur est chargé dans le Page objet.(Hérité de Control.)

System_CAPS_pubeventPreRender

Se produit après le Control objet est chargé, mais avant le rendu.(Hérité de Control.)

System_CAPS_pubeventSelected

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

System_CAPS_pubeventSelecting

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

System_CAPS_pubeventUnload

Se produit lorsque le contrôle serveur est déchargé de la mémoire.(Hérité de Control.)

System_CAPS_pubeventUpdated

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

System_CAPS_pubeventUpdating

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

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_priveventIDataSource.DataSourceChanged

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Se produit lorsqu’un contrôle de source de données a changé d’une manière qui affecte des contrôles liés aux données.(Hérité de DataSourceControl.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIListSource.GetList()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient une liste de contrôles de source de données qui peuvent être utilisés comme sources de listes de données.(Hérité de DataSourceControl.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.GetDesignModeState()

Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.GetDesignModeState.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetDesignModeState(IDictionary)

Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetDesignModeState.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetOwnerControl(Control)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetOwnerControl.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDataSource.GetView(String)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient l’index nommé DataSourceView objet associé à le DataSourceControl contrôle. Certains contrôles de source de données prend en charge qu’un affichage, tandis que d’autres prennent en charge plusieurs fois.(Hérité de DataSourceControl.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDataSource.GetViewNames()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient une collection de noms, représentant la liste des DataSourceView associés à la DataSourceControl contrôle.(Hérité de DataSourceControl.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIParserAccessor.AddParsedSubObject(Object)

Pour obtenir une description de ce membre, consultez IParserAccessor.AddParsedSubObject.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIListSource.ContainsListCollection

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Indique si le contrôle de source de données est associé à une ou plusieurs listes de données.(Hérité de DataSourceControl.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlBuilderAccessor.ControlBuilder

Pour obtenir une description de ce membre, consultez IControlBuilderAccessor.ControlBuilder.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlDesignerAccessor.UserData

Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.UserData.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.DataBindings

Pour obtenir une description de ce membre, consultez IDataBindingsAccessor.DataBindings.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.HasDataBindings

Pour obtenir une description de ce membre, consultez IDataBindingsAccessor.HasDataBindings.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.Expressions

Pour obtenir une description de ce membre, consultez IExpressionsAccessor.Expressions.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.HasExpressions

Pour obtenir une description de ce membre, consultez IExpressionsAccessor.HasExpressions.(Hérité de Control.)

NomDescription
System_CAPS_pubmethodFindDataSourceControl()

Retourne la source de données qui est associée au contrôle de données pour le contrôle spécifié.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodFindFieldTemplate(String)

Retourne que le modèle de champ pour la colonne spécifiée dans le contrôle spécifié du conteneur de dénomination.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodFindMetaTable()

Retourne l’objet metatable pour le contrôle de données conteneur.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodGetDefaultValues()

Surchargé. Obtient la collection des valeurs par défaut pour la source de données spécifiée.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodGetMetaTable()

Surchargé. Obtient les métadonnées pour une table dans l’objet de source de données spécifié.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodTryGetMetaTable(MetaTable)

Surchargé. Détermine si les métadonnées de la table sont disponible.(Défini par DynamicDataExtensions.)

Le contrôle de source de données SqlDataSource représente des données dans une base de données relationnelle SQL pour les contrôles liés aux données. Vous pouvez utiliser le contrôle SqlDataSource conjointement à un contrôle lié aux données pour récupérer des données d'une base de données relationnelle et afficher, modifier et trier des données sur une page Web avec peu ou sans code.

Pour vous connecter à une base de données, vous devez affecter une chaîne de connexion valide à la propriété ConnectionString. SqlDataSource peut prendre en charge n'importe quelle base de données relationnelle SQL à laquelle il est possible de se connecter grâce à un fournisseur ADO.NET, tel que le fournisseur SqlClient, OleDb, Odbc ou OracleClient. Pour plus d'informations sur la sécurisation de chaînes de connexion, consultez How To: Secure Connection Strings when Using Data Source Controls.

Pour récupérer des données d'une base de données sous-jacente, définissez la propriété SelectCommand avec une requête SQL. Si la base de données à laquelle SqlDataSource est associé prend en charge les procédures stockées, vous pouvez affecter le nom d'une procédure stockée à la propriété SelectCommand. La requête SQL que vous spécifiez peut également être une requête paramétrée. Vous pouvez ajouter des objets Parameter associés à une requête paramétrée à la collection SelectParameters. Pour plus d'informations sur les requêtes SQL paramétrées et leur syntaxe, consultez Using Parameters with Data Source Controls for Filtering.

Le contrôle SqlDataSource récupère des données chaque fois que la méthode Select est appelée. Cette méthode fournit un accès par programme à la méthode spécifiée par la propriété SelectMethod. La méthode Select est appelée automatiquement par des contrôles liés au SqlDataSource lorsque leur méthode DataBind est appelée. Si vous définissez la propriété DataSourceID d'un contrôle lié aux données, le contrôle crée automatiquement une liaison avec les données de la source de données, si nécessaire. La définition de la propriété DataSourceID est la méthode recommandée pour lier un contrôle ObjectDataSource à un contrôle lié aux données. Vous pouvez également utiliser la propriété DataSource, mais vous devrez ensuite appeler explicitement la méthode DataBind du contrôle lié aux données. Parmi les contrôles liés aux données pouvant utiliser SqlDataSource, on trouve DataGrid, DetailsView, DataList et DropDownList. Vous pouvez appeler la méthode Select par programme à tout moment pour récupérer les données de la base de données sous-jacente.

Dans les scénarios déclaratifs de programmation et ASP.NET, vous pouvez définir la propriété d'DataSourceID du contrôle lié aux données dans l'ID de contrôle d'SqlDataSource. Vous pouvez également assigner une instance de la classe SqlDataSource à la propriété DataSource du contrôle lié aux données. Pour plus d'informations sur la liaison de contrôles liés aux données à des contrôles de source de données, consultez ASP.NET Data Access Options.

Selon les fonctions du produit de la base de données sous-jacente et la configuration de l'instance de la classe SqlDataSource, vous pouvez exécuter des opérations de données, telles que des mises à jour, des insertions et des suppressions. Pour exécuter ces opérations de données, définissez le texte de commande approprié et tous les paramètres associés pour l'opération que vous souhaitez exécuter. Par exemple, pour une opération de mise à jour, affectez une chaîne SQL ou le nom d'une procédure stockée à la propriété UpdateCommand et ajoutez tous les paramètres requis à la collection UpdateParameters. La mise à jour est effectuée lorsque la méthode Update est appelée, soit explicitement par votre code ou automatiquement par un contrôle lié aux données. Les opérations Delete et Insert suivent le même modèle général.

Les requêtes et commandes SQL que vous utilisez dans les propriétés SelectCommand, UpdateCommand, InsertCommand et DeleteCommand peuvent être paramétrées. Cela signifie que la requête ou commande peut utiliser des espaces réservés au lieu de valeurs littérales et lier les espaces réservés à des variables d'application ou définies par l'utilisateur. Vous pouvez lier des paramètres de requêtes SQL à des variables Session, à des valeurs passées sur la chaîne de requête pour une page Web Forms, aux valeurs de propriété d'autres contrôles serveur, etc. Pour plus d'informations sur l'utilisation de paramètres dans les requêtes SQL avec SqlDataSource, consultez Using Parameters with Data Source Controls for Filtering et Using Parameters with the SqlDataSource Control.

System_CAPS_noteRemarque

Par défaut, si l'un des paramètres est null lorsque vous exécutez une commande Select, aucune donnée n'est retournée et aucune exception n'est levée. Vous pouvez changer ce comportement en attribuant à la propriété CancelSelectOnNullParameter la valeur false.

Par défaut, le contrôle SqlDataSource utilise le fournisseur de données .NET Framework pour SQL Server, mais SqlDataSource n'est pas spécifique à Microsoft SQL Server. Vous pouvez établir une connexion entre le contrôle SqlDataSource et tout produit de base de données disposant d'un fournisseur ADO.NET managé. Lorsqu'il est utilisé avec le fournisseur System.Data.OleDb, SqlDataSource peut fonctionner avec toute base de données conforme à OLE DB. Lorsqu'il est utilisé avec le fournisseur System.Data.Odbc, SqlDataSource peut être utilisé avec tout pilote et base de données ODBC, y compris IBM DB2, MySQL et PostgreSQL. Lorsqu'il est utilisé avec le fournisseur System.Data.OracleClient, SqlDataSource peut fonctionner avec les bases de données Oracle 8.1.7 et versions ultérieures. La liste des fournisseurs autorisés est enregistrée dans la section DbProviderFactories du fichier de configuration, qui est soit le fichier Machine.config, soit le fichier Web.config. Pour plus d'informations, consultez Selecting Data Using the SqlDataSource Control.

Si vous affichez des données sur votre page à l'aide d'un contrôle SqlDataSource, vous pouvez améliorer la performance de la page en utilisant les fonctionnalités de mise en cache de données du contrôle de source de données. La mise en cache réduit la charge de traitement sur les serveurs de base de données aux dépens de la mémoire sur le serveur Web ; dans la plupart des cas, il s'agit d'un bon compromis. SqlDataSource met les données automatiquement en cache lorsque la propriété EnableCaching a la valeur true et lorsque la valeur de la propriété CacheDuration correspond au nombre de secondes pendant lesquelles le cache stocke les données avant que l'entrée du cache ne soit ignorée. Vous pouvez également spécifier un CacheExpirationPolicy et éventuellement une valeur SqlCacheDependency.

SqlDataSource fournit des fonctions supplémentaires, comme répertorié dans le tableau suivant.

Fonctionnalité

Conditions requises

Mise en cache

Affectez la valeur DataSet à la propriété DataSourceMode, la valeur true à la propriété EnableCaching et définissez les propriétés CacheDuration et CacheExpirationPolicy selon le comportement de mise en cache que vous souhaitez pour vos données en mémoire cache.

Suppression

Affectez à la propriété DeleteCommand une instruction SQL utilisée pour supprimer des données. Cette instruction est généralement paramétrée.

Filtrage

Affectez la valeur DataSet à la propriété DataSourceMode. Affectez à la propriété FilterExpression une expression de filtrage utilisée pour filtrer les données lorsque la méthode Select est appelée.

Insertion

Affectez à la propriété InsertCommand une instruction SQL utilisée pour insérer des données. Cette instruction est généralement paramétrée.

Pagination

Non pris en charge actuellement par SqlDataSource. Cependant, certains contrôles liés aux données, tels que GridView, prennent en charge la pagination lorsque vous affectez la valeur DataSet à la propriété DataSourceMode.

Sélection

Affectez à la propriété SelectCommand une instruction SQL utilisée pour récupérer des données.

Tri

Affectez à la propriété DataSourceMode la valeur DataSet.

Mise à jour

Affectez à la propriété UpdateCommand une instruction SQL utilisée pour mettre à jour les données. Cette instruction est généralement paramétrée.

Comme tous les contrôles de source de données, le contrôle SqlDataSource est associé à une classe d'affichage de la source de données. Le contrôle SqlDataSource n'est associé qu'à un SqlDataSourceView et est toujours nommé Table.

Il n'y a pas de rendu visuel du contrôle SqlDataSource ; il est implémenté comme un contrôle. Vous pouvez donc le créer de manière déclarative et lui permettre éventuellement de participer à la gestion d'état. Par conséquent, SqlDataSource ne prend pas en charge les fonctionnalités visuelles, telles que celles fournies par la propriété EnableTheming ou SkinID.

<asp:SqlDataSource
    CacheDuration="string|Infinite"
    CacheExpirationPolicy="Absolute|Sliding"
    CacheKeyDependency="string"
    CancelSelectOnNullParameter="True|False"
    ConflictDetection="OverwriteChanges|CompareAllValues"
    ConnectionString="string"
    DataSourceMode="DataReader|DataSet"
    DeleteCommand="string"
    DeleteCommandType="Text|StoredProcedure"
    EnableCaching="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    FilterExpression="string"
    ID="string"
    InsertCommand="string"
    InsertCommandType="Text|StoredProcedure"
    OldValuesParameterFormatString="string"
    OnDataBinding="DataBinding event handler"
    OnDeleted="Deleted event handler"
    OnDeleting="Deleting event handler"
    OnDisposed="Disposed event handler"
    OnFiltering="Filtering event handler"
    OnInit="Init event handler"
    OnInserted="Inserted event handler"
    OnInserting="Inserting event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnSelected="Selected event handler"
    OnSelecting="Selecting event handler"
    OnUnload="Unload event handler"
    OnUpdated="Updated event handler"
    OnUpdating="Updating event handler"
    ProviderName="string|System.Data.Odbc|System.Data.OleDb|
        System.Data.OracleClient|System.Data.SqlClient|
        Microsoft.SqlServerCe.Client"
    runat="server"
    SelectCommand="string"
    SelectCommandType="Text|StoredProcedure"
    SkinID="string"
    SortParameterName="string"
    SqlCacheDependency="string"
    UpdateCommand="string"
    UpdateCommandType="Text|StoredProcedure"
    Visible="True|False"
>
        <DeleteParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </DeleteParameters>
        <FilterParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </FilterParameters>
        <InsertParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </InsertParameters>
        <SelectParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </SelectParameters>
        <UpdateParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </UpdateParameters>
</asp:SqlDataSource>

Un projet de site Web Visual Studio contenant du code source est disponible pour accompagner cette rubrique : Download.

Cette section comprend quatre exemples de code :

  • Le premier exemple de code illustre comment afficher des données de SQL Server dans un contrôle GridView à l'aide de la syntaxe déclarative.

  • Le deuxième exemple de code illustre comment afficher les données d'une base de données ODBC dans un contrôle GridView à l'aide de la syntaxe déclarative.

  • Le troisième exemple de code illustre comment afficher et mettre à jour des données dans un contrôle GridView.

  • Le quatrième exemple de code illustre comment afficher et mettre à jour des données dans un contrôle DropDownList.

    System_CAPS_noteRemarque

    Ces exemples montrent comment utiliser la syntaxe déclarative pour l'accès aux données. Pour plus d'informations sur l'accès aux données à l'aide de code au lieu de balises, consultez Obtener acceso a los datos en Visual Studio.

L'exemple de code suivant illustre comment utiliser un contrôle SqlDataSource de manière déclarative pour récupérer des données de SQL Server et les afficher dans un contrôle GridView.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

L'exemple de code suivant illustre comment utiliser un contrôle SqlDataSource de manière déclarative pour récupérer les données d'une base de données ODBC et les afficher dans un contrôle GridView. La propriété ProviderName est le nom du fournisseur de données .NET Framework pour ODBC qui est System.Data.Odbc.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >

  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <!-- This example uses a Northwind database that is hosted by an ODBC-compliant
         database. To run this sample, create an ODBC DSN to any database that hosts
         the Northwind database, including Microsoft SQL Server or Microsoft Access,
         change the name of the DSN in the ConnectionString, and view the page.
    -->
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          DataSourceMode="DataReader"
          ConnectionString="dsn=myodbc3dsn;"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

L'exemple de code suivant montre un affichage commun et met à jour le scénario avec le contrôle GridView. Comme pour les exemples précédents, les données de la base de données Northwind sont affichées dans le contrôle GridView. En outre, étant donné qu'une propriété UpdateCommand est spécifiée et que la propriété AutoGenerateEditButton a la valeur true, vous pouvez modifier et mettre à jour les enregistrements sans code supplémentaire. Le contrôle GridView gère automatiquement les paramètres d'ajout à la collection UpdateParameters et appelle la méthode Update lorsque vous cliquez sur le bouton Mettre à jour dans le contrôle GridView.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataSet"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
          UpdateCommand="Update Employees SET FirstName=@FirstName,LastName=@LastName,Title=@Title WHERE EmployeeID=@EmployeeID">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AutoGenerateColumns="False"
          DataKeyNames="EmployeeID"
          AutoGenerateEditButton="True"
          DataSourceID="SqlDataSource1">
          <columns>
              <asp:BoundField HeaderText="First Name" DataField="FirstName" />
              <asp:BoundField HeaderText="Last Name" DataField="LastName" />
              <asp:BoundField HeaderText="Title" DataField="Title" />
          </columns>

      </asp:GridView>

    </form>
  </body>
</html>

L'exemple de code suivant illustre un scénario d'affichage et de mise à jour commun avec les contrôles DropDownList et TextBox. Le contrôle DropDownList n'ajoute pas automatiquement de paramètres de mise à jour à la collection UpdateParameters et n'appelle pas automatiquement la méthode Update. Vous devez donc le faire. Les paramètres de mise à jour sont spécifiés de manière déclarative et vous pouvez ajouter un gestionnaire d'événements pour exécuter l'opération Update lorsqu'un événement est déclenché.

System_CAPS_security Sécurité Remarque

Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages Web ASP.NET vérifient que les entrées d'utilisateur n'incluent pas de script ou d'éléments HTML. Pour plus d'informations, consultez Script Exploits Overview.

<%@Page  Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
 private void On_Click(Object source, EventArgs e) {
    try {
        SqlDataSource1.Update();
    }
    catch (Exception except) {
        // Handle the Exception.
    }

    Label2.Text="The record was updated successfully!";
 }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID, LastName, Address FROM Employees"
          UpdateCommand="UPDATE Employees SET Address=@Address WHERE EmployeeID=@EmployeeID">
          <UpdateParameters>
              <asp:ControlParameter Name="Address" ControlId="TextBox1" PropertyName="Text"/>
              <asp:ControlParameter Name="EmployeeID" ControlId="DropDownList1" PropertyName="SelectedValue"/>
          </UpdateParameters>
      </asp:SqlDataSource>

      <asp:DropDownList
          id="DropDownList1"
          runat="server"
          DataTextField="LastName"
          DataValueField="EmployeeID"
          DataSourceID="SqlDataSource1">
      </asp:DropDownList>

      <br />
      <asp:Label id="Label1" runat="server" Text="Enter a new address for the selected user."
        AssociatedControlID="TextBox1" />
      <asp:TextBox id="TextBox1" runat="server" />
      <asp:Button id="Submit" runat="server" Text="Submit" OnClick="On_Click" />

      <br /><asp:Label id="Label2" runat="server" Text="" />

    </form>
  </body>
</html>

.NET Framework
Disponible depuis 2.0

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: