PageLinkGeneratorExtensions.GetUriByPage Méthode

Définition

Espace de noms:

Microsoft.AspNetCore.Routing

Assembly:

Microsoft.AspNetCore.Mvc.Core.dll

Paquet:

Microsoft.AspNetCore.App.Ref v8.0.0

Surcharges

GetUriByPage(LinkGenerator, String, String, Object, String, HostString, PathString, FragmentString, LinkOptions)	Génère un URI absolu basé sur les valeurs fournies.
GetUriByPage(LinkGenerator, HttpContext, String, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)	Génère un URI absolu basé sur les valeurs fournies.

GetUriByPage(LinkGenerator, String, String, Object, String, HostString, PathString, FragmentString, LinkOptions)

Génère un URI absolu basé sur les valeurs fournies.

public static string? GetUriByPage (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string page, string? handler, object? values, string scheme, Microsoft.AspNetCore.Http.HostString host, Microsoft.AspNetCore.Http.PathString pathBase = default, Microsoft.AspNetCore.Http.FragmentString fragment = default, Microsoft.AspNetCore.Routing.LinkOptions? options = default);

static member GetUriByPage : Microsoft.AspNetCore.Routing.LinkGenerator * string * string * obj * string * Microsoft.AspNetCore.Http.HostString * Microsoft.AspNetCore.Http.PathString * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string

<Extension()>
Public Function GetUriByPage (generator As LinkGenerator, page As String, handler As String, values As Object, scheme As String, host As HostString, Optional pathBase As PathString = Nothing, Optional fragment As FragmentString = Nothing, Optional options As LinkOptions = Nothing) As String

Paramètres

generator

LinkGenerator

L’LinkGeneratoropérateur

page

String

Nom de la page. Utilisé pour résoudre les points de terminaison.

handler

String

Nom du gestionnaire de pages. Ce paramètre peut être null.

values

Object

Valeurs d'itinéraire. Ce paramètre peut être null. Utilisé pour résoudre les points de terminaison et développer les paramètres dans le modèle d’itinéraire.

scheme

String

Schéma d’URI, appliqué à l’URI résultant.

host

HostString

Hôte/autorité d’URI, appliqué à l’URI résultant.

pathBase

PathString

Base de chemin d’uri facultative. Précédé du chemin d’accès dans l’URI résultant.

fragment

FragmentString

Fragment d’URI. Optionnel. Ajouté à l’URI résultant.

options

LinkOptions

LinkOptions facultatif. Les paramètres de l’objet fourni remplacent les paramètres avec des noms correspondants à partir de RouteOptions.

Retours

String

URI absolu ou null si un URI ne peut pas être créé.

Remarques

La valeur de host doit être une valeur approuvée. Le fait de s’appuyer sur la valeur de la requête actuelle peut permettre à une entrée non approuvée d’influencer l’URI résultant, sauf si l’en-tête Host a été validé. Consultez la documentation sur le déploiement pour obtenir des instructions sur la façon de valider correctement l’en-tête Host dans votre environnement de déploiement.

GetUriByPage(LinkGenerator, HttpContext, String, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)

Génère un URI absolu basé sur les valeurs fournies.

public static string? GetUriByPage (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string? page = default, string? handler = default, object? values = default, string? scheme = default, Microsoft.AspNetCore.Http.HostString? host = default, Microsoft.AspNetCore.Http.PathString? pathBase = default, Microsoft.AspNetCore.Http.FragmentString fragment = default, Microsoft.AspNetCore.Routing.LinkOptions? options = default);

static member GetUriByPage : Microsoft.AspNetCore.Routing.LinkGenerator * Microsoft.AspNetCore.Http.HttpContext * string * string * obj * string * Nullable<Microsoft.AspNetCore.Http.HostString> * Nullable<Microsoft.AspNetCore.Http.PathString> * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string

<Extension()>
Public Function GetUriByPage (generator As LinkGenerator, httpContext As HttpContext, Optional page As String = Nothing, Optional handler As String = Nothing, Optional values As Object = Nothing, Optional scheme As String = Nothing, Optional host As Nullable(Of HostString) = Nothing, Optional pathBase As Nullable(Of PathString) = Nothing, Optional fragment As FragmentString = Nothing, Optional options As LinkOptions = Nothing) As String

Paramètres

generator

LinkGenerator

L’LinkGeneratoropérateur

httpContext

HttpContext

HttpContext associé à la demande actuelle.

page

String

Nom de la page. Utilisé pour résoudre les points de terminaison. Optionnel. Si null est fourni, la valeur d’itinéraire de page actuelle est utilisée.

handler

String

Nom du gestionnaire de pages. Utilisé pour résoudre les points de terminaison. Optionnel.

values

Object

Valeurs d'itinéraire. Optionnel. Utilisé pour résoudre les points de terminaison et développer les paramètres dans le modèle d’itinéraire.

scheme

String

Schéma d’URI, appliqué à l’URI résultant. Optionnel. Si elle n’est pas fournie, la valeur de Scheme sera utilisée.

host

Nullable<HostString>

Hôte/autorité d’URI, appliqué à l’URI résultant. Optionnel. Si elle n’est pas fournie, la valeur Host est utilisée.

pathBase

Nullable<PathString>

Base de chemin d’uri facultative. Précédé du chemin d’accès dans l’URI résultant. Si elle n’est pas fournie, la valeur de PathBase sera utilisée.

fragment

FragmentString

Fragment d’URI. Optionnel. Ajouté à l’URI résultant.

options

LinkOptions

LinkOptions facultatif. Les paramètres de l’objet fourni remplacent les paramètres avec des noms correspondants à partir de RouteOptions.

Retours

String

URI absolu ou null si un URI ne peut pas être créé.

Remarques

La valeur de host doit être une valeur approuvée. Le fait de s’appuyer sur la valeur de la requête actuelle peut permettre à une entrée non approuvée d’influencer l’URI résultant, sauf si l’en-tête Host a été validé. Consultez la documentation sur le déploiement pour obtenir des instructions sur la façon de valider correctement l’en-tête Host dans votre environnement de déploiement.