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

RouteParameter, classe

.NET Framework (current version)
 

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

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

System.Object
  System.Web.UI.WebControls.Parameter
    System.Web.UI.WebControls.RouteParameter

public class RouteParameter : Parameter

NomDescription
System_CAPS_pubmethodRouteParameter()

Initialise une nouvelle instance de la classe RouteParameter.

System_CAPS_protmethodRouteParameter(RouteParameter)

Initialise une nouvelle instance de la RouteParameter classe en utilisant les valeurs de l'instance spécifiée.

System_CAPS_pubmethodRouteParameter(String, DbType, String)

Initialise une nouvelle instance de la RouteParameter classe en utilisant le nom spécifié et le type de base de données pour le paramètre et à l'aide de la clé spécifiée pour les données d'itinéraire.

System_CAPS_pubmethodRouteParameter(String, String)

Initialise une nouvelle instance de la RouteParameter classe en utilisant le nom spécifié pour le paramètre et la clé spécifiée pour les données d'itinéraire.

System_CAPS_pubmethodRouteParameter(String, TypeCode, String)

Initialise une nouvelle instance de la RouteParameter classe en utilisant le nom spécifié et le type du paramètre et à l'aide de la clé spécifiée pour les données d'itinéraire.

NomDescription
System_CAPS_pubpropertyConvertEmptyStringToNull

Obtient ou définit une valeur indiquant si la valeur que le Parameter objet est lié doit être convertie à null si elle est String.Empty.(Hérité de Parameter.)

System_CAPS_pubpropertyDbType

Obtient ou définit le type de base de données du paramètre.(Hérité de Parameter.)

System_CAPS_pubpropertyDefaultValue

Spécifie une valeur par défaut pour le paramètre, doit la valeur du paramètre est lié à sans être initialisé quand la Evaluate méthode est appelée.(Hérité de Parameter.)

System_CAPS_pubpropertyDirection

Indique si le Parameter objet est utilisé pour lier une valeur à un contrôle, ou le contrôle peut être utilisé pour modifier la valeur.(Hérité de Parameter.)

System_CAPS_protpropertyIsTrackingViewState

Obtient une valeur indiquant si le Parameter objet enregistre les modifications apportées à son état d'affichage.(Hérité de Parameter.)

System_CAPS_pubpropertyName

Obtient ou définit le nom du paramètre.(Hérité de Parameter.)

System_CAPS_pubpropertyRouteKey

Obtient ou définit le nom du segment d'itinéraire à partir de laquelle récupérer la valeur du paramètre d'itinéraire.

System_CAPS_pubpropertySize

Obtient ou définit la taille du paramètre.(Hérité de Parameter.)

System_CAPS_pubpropertyType

Obtient ou définit le type du paramètre.(Hérité de Parameter.)

System_CAPS_protpropertyViewState

Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et restaurer l'état d'affichage d'un Parameter objet entre plusieurs demandes de la même page.(Hérité de Parameter.)

NomDescription
System_CAPS_protmethodClone()

Retourne un doublon de l'utilisateur actuel RouteParameter instance.(Remplace Parameter.Clone().)

System_CAPS_pubmethodEquals(Object)

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

System_CAPS_protmethodEvaluate(HttpContext, Control)

Évalue l'URL de requête et retourne la valeur du paramètre.(Remplace Parameter.Evaluate(HttpContext, Control).)

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_pubmethodGetDatabaseType()

Obtient le DbType valeur équivalente au type CLR de l'utilisateur actuel Parameter instance.(Hérité de Parameter.)

System_CAPS_pubmethodGetHashCode()

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

System_CAPS_pubmethodGetType()

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

System_CAPS_protmethodLoadViewState(Object)

Restaure la vue de source de données enregistré précédemment l'état d'affichage.(Hérité de Parameter.)

System_CAPS_protmethodMemberwiseClone()

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

System_CAPS_protmethodOnParameterChanged()

Appels du OnParametersChanged Procédé de la ParameterCollection collection qui contient le Parameter objet.(Hérité de Parameter.)

System_CAPS_protmethodSaveViewState()

Enregistre les modifications apportées à la Parameter état d'affichage de l'objet depuis la publication de la page sur le serveur.(Hérité de Parameter.)

System_CAPS_protmethodSetDirty()

Marque le Parameter donc son état est enregistré dans l'état d'affichage de l'objet.(Hérité de Parameter.)

System_CAPS_pubmethodToString()

Convertit la valeur de cette instance en sa représentation sous forme de chaîne équivalente.(Hérité de Parameter.)

System_CAPS_protmethodTrackViewState()

Provoque la Parameter objet à suivre les modifications apportées à son état d'affichage afin qu'ils puissent être stockées dans le contrôle ViewState objet et être persistantes entre les demandes pour la même page.(Hérité de Parameter.)

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodICloneable.Clone()

Retourne un doublon de l'utilisateur actuel Parameter instance.(Hérité de Parameter.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.LoadViewState(Object)

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Restaure la vue de source de données enregistré précédemment l'état d'affichage.(Hérité de Parameter.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.SaveViewState()

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Enregistre les modifications apportées à la Parameter état d'affichage de l'objet depuis la publication de la page sur le serveur.(Hérité de Parameter.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.TrackViewState()

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Provoque la Parameter objet à suivre les modifications apportées à son état d'affichage afin qu'ils puissent être stockées dans le contrôle ViewState objet et être persistantes entre les demandes pour la même page.(Hérité de Parameter.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIStateManager.IsTrackingViewState

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Obtient une valeur indiquant si le Parameter objet enregistre les modifications apportées à son état d'affichage.(Hérité de Parameter.)

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

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

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

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

L'exemple suivant illustre la page Product.aspx. La page contient un SqlDataSource contrôle ayant une requête qui nécessite deux paramètres, un pour le nom du produit et un pour la langue de la description du produit. RouteParameter objets sont utilisés pour fournir les valeurs pour les paramètres de requête. La valeur du paramètre d'URL de routage productname est passée au paramètre de requête @productname. La valeur du paramètre d'URL de routage culture est passée au paramètre de requête @culture. Si une URL de routage n'inclut pas le paramètre d'URL culture, une valeur par défaut de « en » est utilisée.

L'exemple suivant montre une page nommée ProductLinks.aspx, qui contient des liens hypertexte vers la page Product.aspx en utilisant l'URL de routage. Utilisez ces liens hypertexte RouteUrl expressions pour créer des URL d'itinéraire. Le premier lien n'inclut pas un culture paramètre d'itinéraire. Par conséquent, la valeur par défaut de « en » est défini dans le RouteParameter pour l'objet @culture paramètre de requête sera utilisé dans la requête. Le deuxième lien fournit un culture valeur de « fr », ce qui provoque la description à afficher en français. Pour plus d'informations sur l'utilisation de RouteUrl les expressions, consultez How to: Construct URLs from Routes.

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

ProductID

name

Description

994

LL Bottom Bracket

Chromoly steel.

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

ProductID

name

Description

994

LL Bottom Bracket

Acier chromé.

Pour exécuter cet exemple, ajoutez les deux pages .aspx et le code dans le fichier Global.asax à une 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 définition 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 la page ASP.NET Routing.

.NET Framework
Disponible depuis 4.0

Tous les membres statiques (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Retour au début
Afficher: