ControllerLinkGeneratorExtensions.GetUriByAction 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
| GetUriByAction(LinkGenerator, String, String, Object, String, HostString, PathString, FragmentString, LinkOptions) |
Génère un URI absolu basé sur les valeurs fournies. |
| GetUriByAction(LinkGenerator, HttpContext, String, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions) |
Génère un URI absolu basé sur les valeurs fournies. |
GetUriByAction(LinkGenerator, String, String, Object, String, HostString, PathString, FragmentString, LinkOptions)
Génère un URI absolu basé sur les valeurs fournies.
public static string GetUriByAction (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string action, string controller, 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? GetUriByAction (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string action, string controller, 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? GetUriByAction (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string action, string controller, 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 GetUriByAction : 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 GetUriByAction (generator As LinkGenerator, action As String, controller 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 StringParamètres
- generator
- LinkGenerator
L’LinkGeneratoropérateur
- action
- String
Nom de l’action. Utilisé pour résoudre les points de terminaison.
- controller
- String
Nom du contrôleur. Utilisé pour résoudre les points de terminaison.
- 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
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.
S’applique à
GetUriByAction(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 GetUriByAction (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string action = default, string controller = 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);public static string? GetUriByAction (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string? action = default, string? controller = 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 GetUriByAction : 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 GetUriByAction (generator As LinkGenerator, httpContext As HttpContext, Optional action As String = Nothing, Optional controller 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 StringParamètres
- generator
- LinkGenerator
L’LinkGeneratoropérateur
- httpContext
- HttpContext
HttpContext associé à la demande actuelle.
- action
- String
Nom de l’action. Utilisé pour résoudre les points de terminaison. Optionnel. Si null est fourni, la valeur de routage d’action actuelle sera utilisée.
- controller
- String
Nom du contrôleur. Utilisé pour résoudre les points de terminaison. Optionnel. Si null est fourni, la valeur d’itinéraire du contrôleur actuelle est utilisée.
- 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
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.