LinkGenerator.GetUriByAddress Méthode

Définition

Surcharges

GetUriByAddress<TAddress>(TAddress, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)

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

GetUriByAddress<TAddress>(HttpContext, TAddress, RouteValueDictionary, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)

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

GetUriByAddress<TAddress>(TAddress, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)

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

public abstract string GetUriByAddress<TAddress> (TAddress address, Microsoft.AspNetCore.Routing.RouteValueDictionary 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);
public abstract string? GetUriByAddress<TAddress> (TAddress address, Microsoft.AspNetCore.Routing.RouteValueDictionary 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);
public abstract string? GetUriByAddress<TAddress> (TAddress address, Microsoft.AspNetCore.Routing.RouteValueDictionary 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);
abstract member GetUriByAddress : 'Address * Microsoft.AspNetCore.Routing.RouteValueDictionary * string * Microsoft.AspNetCore.Http.HostString * Microsoft.AspNetCore.Http.PathString * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string
Public MustOverride Function GetUriByAddress(Of TAddress) (address As TAddress, values As RouteValueDictionary, 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 de type

TAddress

Type d’adresse.

Paramètres

address
TAddress

Valeur d’adresse. Utilisé pour résoudre les points de terminaison.

values
RouteValueDictionary

Valeurs d'itinéraire. Permet de 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

L’hôte/l’autorité d’URI, appliqué à l’URI résultant. Consultez la section remarques pour plus d’informations sur les implications de sécurité de .host

pathBase
PathString

Base de chemin d’URI facultative. Ajouté au chemin d’accès dans l’URI résultant.

fragment
FragmentString

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

options
LinkOptions

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

Retours

URI absolu, ou null.

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.

S’applique à

GetUriByAddress<TAddress>(HttpContext, TAddress, RouteValueDictionary, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)

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

public abstract string GetUriByAddress<TAddress> (Microsoft.AspNetCore.Http.HttpContext httpContext, TAddress address, Microsoft.AspNetCore.Routing.RouteValueDictionary values, Microsoft.AspNetCore.Routing.RouteValueDictionary ambientValues = 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);
public abstract string? GetUriByAddress<TAddress> (Microsoft.AspNetCore.Http.HttpContext httpContext, TAddress address, Microsoft.AspNetCore.Routing.RouteValueDictionary values, Microsoft.AspNetCore.Routing.RouteValueDictionary? ambientValues = 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);
abstract member GetUriByAddress : Microsoft.AspNetCore.Http.HttpContext * 'Address * Microsoft.AspNetCore.Routing.RouteValueDictionary * Microsoft.AspNetCore.Routing.RouteValueDictionary * string * Nullable<Microsoft.AspNetCore.Http.HostString> * Nullable<Microsoft.AspNetCore.Http.PathString> * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string
Public MustOverride Function GetUriByAddress(Of TAddress) (httpContext As HttpContext, address As TAddress, values As RouteValueDictionary, Optional ambientValues As RouteValueDictionary = 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 de type

TAddress

Type d’adresse.

Paramètres

httpContext
HttpContext

HttpContext associé à la requête actuelle.

address
TAddress

Valeur d’adresse. Utilisé pour résoudre les points de terminaison.

values
RouteValueDictionary

Valeurs d'itinéraire. Permet de développer les paramètres dans le modèle d’itinéraire.

ambientValues
RouteValueDictionary

Valeurs associées à la requête actuelle. Optionnel.

scheme
String

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

host
Nullable<HostString>

L’hôte/l’autorité d’URI, appliqué à l’URI résultant. Optionnel. Si elle n’est pas fournie, la valeur Host est utilisée. Consultez la section remarques pour plus d’informations sur les implications de sécurité de .host

pathBase
Nullable<PathString>

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

fragment
FragmentString

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

options
LinkOptions

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

Retours

URI avec un chemin absolu, ou null.

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.

S’applique à