RouteParameter Classe

Référence

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.

Lie la valeur d’un segment d’URL à un objet de paramètre.

public ref class RouteParameter : System::Web::UI::WebControls::Parameter

public class RouteParameter : System.Web.UI.WebControls.Parameter

type RouteParameter = class
    inherit Parameter

Public Class RouteParameter
Inherits Parameter

Héritage: Object

Parameter
RouteParameter

Exemples

Les exemples de cette section montrent comment utiliser RouteParameter des objets dans le balisage pour passer des valeurs de paramètre d’URL à une requête spécifiée pour un contrôle de source de données.

L’exemple suivant montre le code dans la page Global.asax qui définit un itinéraire nommé ProductRoute. L’itinéraire définit un paramètre d’URL nommé productname. L’itinéraire définit également un paramètre catchall facultatif nommé culture, qui peut être utilisé pour spécifier la langue dans laquelle la description du produit est affichée. La page Product.aspx gère les demandes pour cet itinéraire.

L’exemple suivant montre la page Product.aspx. La page contient un SqlDataSource contrôle qui a une requête qui nécessite deux paramètres, l’un pour le nom du produit et l’autre pour la langue de la description du produit. RouteParameter Les objets sont utilisés pour fournir les valeurs des paramètres de requête. La valeur du paramètre productname d’URL d’itinéraire est passée au paramètre @productnamede requête . La valeur du paramètre culture d’URL d’itinéraire est passée au paramètre @culturede requête . Si une URL d’itinéraire n’inclut pas le paramètre cultureURL , une valeur par défaut « en » est utilisée.

L’exemple suivant montre une page nommée ProductLinks.aspx, qui contient des liens hypertexte vers la page Product.aspx à l’aide d’URL de routage. Ces liens hypertexte utilisent RouteUrl des expressions pour créer des URL de routage. Le premier lien n’inclut pas de paramètre d’itinéraire culture . Par conséquent, la valeur par défaut « en » définie dans l’objet pour @culture le RouteParameter paramètre de requête sera utilisée dans la requête. Le deuxième lien fournit la culture valeur « fr », ce qui entraîne l’affichage de la description dans Français. Pour plus d’informations sur l’utilisation RouteUrl des expressions, consultez Guide pratique pour construire des URL à partir d’itinéraires.

Lorsque vous cliquez sur le premier lien hypertexte, vous voyez la page Product.aspx avec les valeurs suivantes dans le GridView contrôle :

ProductID	Nom	Description
`994`	`LL Bottom Bracket`	`Chromoly steel.`

Lorsque vous cliquez sur le deuxième lien hypertexte, les valeurs suivantes s’affichent dans le GridView contrôle :

ProductID	Nom	Description
`994`	`LL Bottom Bracket`	`Acier chromé.`

Pour exécuter cet exemple, ajoutez les deux pages .aspx et le code du fichier Global.asax à un site web ASP.NET ou une application web qui définit une chaîne de connexion nommée AdventureWorksLTConnectionString pour la base de données AdventureWorksLT. Pour plus d’informations sur la configuration d’une connexion à la base de données AdventureWorksLT, consultez How to: Set Up an AdventureWorksLT Sample Database for ASP.NET Development.

Pour plus d’informations sur le routage ASP.NET, consultez Routage ASP.NET.

Remarques

Si vous implémentez ASP.NET routage dans un site Web, vous pouvez utiliser l’objet RouteParameter pour lier la valeur d’un segment de l’URL demandée à une requête ou une commande de base de données. Vous pouvez déclarer RouteParameter des objets dans le balisage pour les contrôles de source de données ou le QueryExtender contrôle .

Un projet de site Web Visual Studio avec du code source est disponible pour accompagner cette rubrique : Télécharger.

Constructeurs

RouteParameter()	Initialise une nouvelle instance de la classe RouteParameter.
RouteParameter(RouteParameter)	Initialise une nouvelle instance de la classe RouteParameter à l'aide des valeurs de l'instance spécifiée.
RouteParameter(String, DbType, String)	Initialise une nouvelle instance de la classe RouteParameter en utilisant le nom et le type de base de données spécifiés pour le paramètre, et la clé spécifiée pour les données d'itinéraire.
RouteParameter(String, String)	Initialise une nouvelle instance de la classe RouteParameter en utilisant le nom spécifié pour le paramètre, et la clé spécifiée pour les données d'itinéraire.
RouteParameter(String, TypeCode, String)	Initialise une nouvelle instance de la classe RouteParameter en utilisant le nom et le type spécifiés pour le paramètre, et la clé spécifiée pour les données d'itinéraire.

Propriétés

ConvertEmptyStringToNull	Obtient ou définit une valeur indiquant si la valeur à laquelle l'objet Parameter est lié doit être convertie en `null` si elle est Empty. (Hérité de Parameter)
DbType	Obtient ou définit le type de base de données du paramètre. (Hérité de Parameter)
DefaultValue	Spécifie une valeur par défaut pour le paramètre, à condition que la valeur à laquelle le paramètre est lié à ne soit pas initialisée lorsque la méthode Evaluate(HttpContext, Control) est appelée. (Hérité de Parameter)
Direction	Indique si l'objet Parameter est utilisé pour lier une valeur à un contrôle ou si le contrôle peut être utilisé pour modifier la valeur. (Hérité de Parameter)
IsTrackingViewState	Obtient une valeur indiquant si l'objet Parameter enregistre les modifications apportées à son état d'affichage. (Hérité de Parameter)
Name	Obtient ou définit le nom du paramètre. (Hérité de Parameter)
RouteKey	Obtient ou définit le nom du segment d'itinéraire à partir duquel la valeur pour le paramètre d'itinéraire doit être extraite.
Size	Obtient ou définit la taille du paramètre. (Hérité de Parameter)
Type	Obtient ou définit le type du paramètre. (Hérité de Parameter)
ViewState	Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un objet Parameter entre plusieurs demandes de la même page. (Hérité de Parameter)

Méthodes

Clone()	Retourne un doublon de l'instance de RouteParameter actuelle.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
Evaluate(HttpContext, Control)	Évalue l'URL de requête et retourne la valeur du paramètre.
GetDatabaseType()	Obtient la valeur DbType qui est équivalente au type CLR de l'instance Parameter actuelle. (Hérité de Parameter)
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)
LoadViewState(Object)	Restaure l'état d'affichage enregistré précédemment pour la vue de source de données. (Hérité de Parameter)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnParameterChanged()	Appelle la méthode OnParametersChanged(EventArgs) de la collection ParameterCollection qui contient l'objet Parameter. (Hérité de Parameter)
SaveViewState()	Enregistre les modifications apportées à l'état d'affichage de l'objet Parameter depuis la publication de la page sur le serveur. (Hérité de Parameter)
SetDirty()	Marque l'objet Parameter afin que son état soit enregistré dans l'état d'affichage. (Hérité de Parameter)
ToString()	Convertit la valeur de cette instance en sa représentation sous forme de chaîne équivalente. (Hérité de Parameter)
TrackViewState()	Ainsi, l'objet Parameter effectue le suivi des modifications de son état d'affichage afin qu'elles puissent être stockées dans l'objet ViewState du contrôle et être persistantes entre les demandes de la même page. (Hérité de Parameter)

Implémentations d’interfaces explicites

ICloneable.Clone()	Retourne un doublon de l'instance de Parameter actuelle. (Hérité de Parameter)
IStateManager.IsTrackingViewState	Obtient une valeur indiquant si l'objet Parameter enregistre les modifications apportées à son état d'affichage. (Hérité de Parameter)
IStateManager.LoadViewState(Object)	Restaure l'état d'affichage enregistré précédemment pour la vue de source de données. (Hérité de Parameter)
IStateManager.SaveViewState()	Enregistre les modifications apportées à l'état d'affichage de l'objet Parameter depuis la publication de la page sur le serveur. (Hérité de Parameter)
IStateManager.TrackViewState()	Ainsi, l'objet Parameter effectue le suivi des modifications de son état d'affichage afin qu'elles puissent être stockées dans l'objet ViewState du contrôle et être persistantes entre les demandes de la même page. (Hérité de Parameter)

S’applique à