LinkGeneratorEndpointNameAddressExtensions.GetUriByName Méthode
Définition
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.
Surcharges
GetUriByName(LinkGenerator, String, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions) |
Génère un URI absolu basé sur les valeurs fournies. |
GetUriByName(LinkGenerator, String, Object, String, HostString, PathString, FragmentString, LinkOptions) |
Génère un URI absolu basé sur les valeurs fournies. |
GetUriByName(LinkGenerator, HttpContext, String, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions) |
Génère un URI absolu basé sur les valeurs fournies. |
GetUriByName(LinkGenerator, HttpContext, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions) |
Génère un URI absolu basé sur les valeurs fournies. |
GetUriByName(LinkGenerator, String, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)
Génère un URI absolu basé sur les valeurs fournies.
public static string? GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string endpointName, 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);
static member GetUriByName : Microsoft.AspNetCore.Routing.LinkGenerator * string * Microsoft.AspNetCore.Routing.RouteValueDictionary * string * Microsoft.AspNetCore.Http.HostString * Microsoft.AspNetCore.Http.PathString * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string
<Extension()>
Public Function GetUriByName (generator As LinkGenerator, endpointName As String, 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
- generator
- LinkGenerator
L’LinkGeneratoropérateur
- endpointName
- String
Nom du point de terminaison. 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 à
GetUriByName(LinkGenerator, String, Object, String, HostString, PathString, FragmentString, LinkOptions)
Génère un URI absolu basé sur les valeurs fournies.
public static string GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string endpointName, 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);
public static string? GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string endpointName, 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 GetUriByName : Microsoft.AspNetCore.Routing.LinkGenerator * string * obj * string * Microsoft.AspNetCore.Http.HostString * Microsoft.AspNetCore.Http.PathString * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string
<Extension()>
Public Function GetUriByName (generator As LinkGenerator, endpointName 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
- endpointName
- String
Nom du point de terminaison. Utilisé pour résoudre les points de terminaison.
- values
- Object
Valeurs d'itinéraire. Permet de développer les paramètres dans le modèle d’itinéraire. Optionnel.
- 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 à
GetUriByName(LinkGenerator, HttpContext, String, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
Génère un URI absolu basé sur les valeurs fournies.
public static string? GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string endpointName, Microsoft.AspNetCore.Routing.RouteValueDictionary? 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 GetUriByName : Microsoft.AspNetCore.Routing.LinkGenerator * Microsoft.AspNetCore.Http.HttpContext * string * Microsoft.AspNetCore.Routing.RouteValueDictionary * string * Nullable<Microsoft.AspNetCore.Http.HostString> * Nullable<Microsoft.AspNetCore.Http.PathString> * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string
<Extension()>
Public Function GetUriByName (generator As LinkGenerator, httpContext As HttpContext, endpointName As String, Optional values 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
- generator
- LinkGenerator
L’LinkGeneratoropérateur
- httpContext
- HttpContext
HttpContext associé à la requête actuelle.
- endpointName
- String
Nom du point de terminaison. 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. 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 à
GetUriByName(LinkGenerator, HttpContext, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
Génère un URI absolu basé sur les valeurs fournies.
public static string GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string endpointName, object values, 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 static string? GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string endpointName, object? values, 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 GetUriByName : Microsoft.AspNetCore.Routing.LinkGenerator * Microsoft.AspNetCore.Http.HttpContext * 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 GetUriByName (generator As LinkGenerator, httpContext As HttpContext, endpointName As String, values As Object, 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 requête actuelle.
- endpointName
- String
Nom du point de terminaison. Utilisé pour résoudre les points de terminaison.
- values
- Object
Valeurs d'itinéraire. Permet de développer les paramètres dans le modèle d’itinéraire. 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.