Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

RouteParameter, classe

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

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

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

public class RouteParameter : Parameter

Le type RouteParameter expose les membres suivants.

  NomDescription
Méthode publiqueRouteParameter()Initialise une nouvelle instance de la classe RouteParameter.
Méthode protégéeRouteParameter(RouteParameter)Initialise une nouvelle instance de la classe RouteParameter à l'aide des valeurs de l'instance spécifiée.
Méthode publiqueRouteParameter(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.
Méthode publiqueRouteParameter(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.
Méthode publiqueRouteParameter(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.
Début

  NomDescription
Propriété publiqueConvertEmptyStringToNullObtient ou définit une valeur indiquant si la valeur à laquelle l'objet Parameter est lié doit être convertie en null si elle est String.Empty. (Hérité de Parameter.)
Propriété publiqueDbTypeObtient ou définit le type de base de données du paramètre. (Hérité de Parameter.)
Propriété publiqueDefaultValueSpé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 est appelée. (Hérité de Parameter.)
Propriété publiqueDirectionIndique 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.)
Propriété protégéeIsTrackingViewStateObtient une valeur indiquant si l'objet Parameter enregistre les modifications apportées à son état d'affichage. (Hérité de Parameter.)
Propriété publiqueNameObtient ou définit le nom du paramètre. (Hérité de Parameter.)
Propriété publiqueRouteKeyObtient ou définit le nom du segment d'itinéraire à partir duquel la valeur pour le paramètre d'itinéraire doit être extraite.
Propriété publiqueSizeObtient ou définit la taille du paramètre. (Hérité de Parameter.)
Propriété publiqueTypeObtient ou définit le type du paramètre. (Hérité de Parameter.)
Propriété protégéeViewStateObtient 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.)
Début

  NomDescription
Méthode protégéeCloneRetourne un doublon de l'instance RouteParameter actuelle. (Substitue Parameter.Clone().)
Méthode publiqueEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégéeEvaluateÉvalue l'URL de requête et retourne la valeur du paramètre. (Substitue Parameter.Evaluate(HttpContext, Control).)
Méthode protégéeFinalize 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.)
Méthode publiqueGetDatabaseTypeObtient la valeur DbType qui est équivalente au type CLR de l'instance Parameter actuelle. (Hérité de Parameter.)
Méthode publiqueGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégéeLoadViewStateRestaure l'état d'affichage enregistré précédemment pour la vue de source de données. (Hérité de Parameter.)
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode protégéeOnParameterChangedAppelle la méthode OnParametersChanged de la collection ParameterCollection qui contient l'objet Parameter. (Hérité de Parameter.)
Méthode protégéeSaveViewStateEnregistre 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.)
Méthode protégéeSetDirtyMarque l'objet Parameter afin que son état soit enregistré dans l'état d'affichage. (Hérité de Parameter.)
Méthode publiqueToStringConvertit la valeur de cette instance en sa représentation sous forme de chaîne équivalente. (Hérité de Parameter.)
Méthode protégéeTrackViewStateAinsi, 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.)
Début

  NomDescription
Implémentation d'interface expliciteMéthode privéeICloneable.CloneRetourne un doublon de l'instance de Parameter actuelle. (Hérité de Parameter.)
Implémentation d'interface explicitePropriété privéeIStateManager.IsTrackingViewStateInfrastructure. Obtient une valeur indiquant si l'objet Parameter enregistre les modifications apportées à son état d'affichage. (Hérité de Parameter.)
Implémentation d'interface expliciteMéthode privéeIStateManager.LoadViewStateInfrastructure. Restaure l'état d'affichage enregistré précédemment pour la vue de source de données. (Hérité de Parameter.)
Implémentation d'interface expliciteMéthode privéeIStateManager.SaveViewStateInfrastructure. 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.)
Implémentation d'interface expliciteMéthode privéeIStateManager.TrackViewStateInfrastructure. 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.)
Début

Si vous implémentez le routage ASP.NET 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 de base de données ou une commande. Vous pouvez déclarer des objets RouteParameter dans le balisage pour les contrôles de source de données ou le contrôle QueryExtender.

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

Les exemples de cette section indiquent comment utiliser des objets RouteParameter 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 affiche le code dans la page Global.asax qui définit un itinéraire nommé ProductRoute. L'itinéraire définit un paramètre 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 est affichée. La page Product.aspx gère les demandes pour cet itinéraire.

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


<%@ Page %>

<!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>Product Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <h1>Product Page</h1>
        <asp:SqlDataSource ID="SqlDataSource1" runat="server" 
            ConnectionString="<%$ ConnectionStrings:AdventureWorksLTConnectionString %>" 
            SelectCommand="SELECT SalesLT.Product.ProductID, 
                SalesLT.Product.Name, 
                SalesLT.ProductDescription.Description 
                FROM SalesLT.Product 
                INNER JOIN SalesLT.ProductModel 
                ON SalesLT.Product.ProductModelID = 
                SalesLT.ProductModel.ProductModelID 
                INNER JOIN SalesLT.ProductModelProductDescription 
                ON SalesLT.ProductModel.ProductModelID = 
                SalesLT.ProductModelProductDescription.ProductModelID 
                INNER JOIN SalesLT.ProductDescription 
                ON SalesLT.ProductModelProductDescription.ProductDescriptionID = 
                SalesLT.ProductDescription.ProductDescriptionID 
                WHERE (SalesLT.ProductModelProductDescription.Culture = @culture) 
                AND (SalesLT.Product.Name = @productname)">
            <SelectParameters>
                <asp:RouteParameter DefaultValue="en" Name="culture" RouteKey="culture" />
                <asp:RouteParameter Name="productname" RouteKey="productname" />
            </SelectParameters>
        </asp:SqlDataSource>
        <asp:GridView ID="GridView1" runat="server" 
            DataSourceID="SqlDataSource1">
        </asp:GridView>
    </div>
    </form>
</body>
</html>


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


<%@ Page %>

<!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>Product Links Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <h1>
            Product Links Page
        </h1>
        <asp:HyperLink ID="HyperLink1" runat="server" 
            NavigateUrl="<%$RouteUrl:routename=productroute,productname=LL Bottom Bracket%>">
            Product page for LL Bottom Bracket</asp:HyperLink>
        <br />
        <asp:HyperLink ID="HyperLink8" runat="server" 
            NavigateUrl="<%$RouteUrl:routename=productroute,productname=LL Bottom Bracket,culture=fr%>">
            Product page for LL Bottom Bracket (French)</asp:HyperLink>
    </div>
    </form>
</body>
</html>


Lorsque vous cliquez sur le premier lien hypertexte, la page Product.aspx s'affiche avec le contrôle GridView comportant les valeurs suivantes :

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 contrôle GridView :

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 à 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 d'ASP.NET, consultez ASP.NET Routing.

.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

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

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft