ControllerLinkGeneratorExtensions.GetUriByAction Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| GetUriByAction(LinkGenerator, String, String, Object, String, HostString, PathString, FragmentString, LinkOptions) |
Gera um URI absoluto com base nos valores fornecidos. |
| GetUriByAction(LinkGenerator, HttpContext, String, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions) |
Gera um URI absoluto com base nos valores fornecidos. |
GetUriByAction(LinkGenerator, String, String, Object, String, HostString, PathString, FragmentString, LinkOptions)
Gera um URI absoluto com base nos valores fornecidos.
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 StringParâmetros
- generator
- LinkGenerator
- action
- String
O nome da ação. Usado para resolve pontos de extremidade.
- controller
- String
O nome do controlador. Usado para resolve pontos de extremidade.
- values
- Object
Os valores de rota. Pode ser nulo. Usado para resolve pontos de extremidade e expandir parâmetros no modelo de rota.
- scheme
- String
O esquema de URI, aplicado ao URI resultante.
- host
- HostString
O host/autoridade de URI, aplicado ao URI resultante.
- pathBase
- PathString
Uma base de caminho de URI opcional. Anexado ao caminho no URI resultante.
- fragment
- FragmentString
Um fragmento de URI. Opcional. Acrescentado ao URI resultante.
- options
- LinkOptions
Um LinkOptions opcional. As configurações no objeto fornecido substituem as configurações com nomes correspondentes de RouteOptions.
Retornos
Um URI absoluto ou null se um URI não puder ser criado.
Comentários
O valor de host deve ser um valor confiável. Depender do valor da solicitação atual pode permitir que a entrada não confiável influencie o URI resultante, a menos que o Host cabeçalho tenha sido validado. Consulte a documentação de implantação para obter instruções sobre como validar corretamente o Host cabeçalho em seu ambiente de implantação.
Aplica-se a
GetUriByAction(LinkGenerator, HttpContext, String, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
Gera um URI absoluto com base nos valores fornecidos.
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 StringParâmetros
- generator
- LinkGenerator
- httpContext
- HttpContext
O HttpContext associado à solicitação atual.
- action
- String
O nome da ação. Usado para resolve pontos de extremidade. Opcional. Se null for fornecido, o valor da rota de ação atual será usado.
- controller
- String
O nome do controlador. Usado para resolve pontos de extremidade. Opcional. Se null for fornecido, o valor da rota do controlador atual será usado.
- values
- Object
Os valores de rota. Opcional. Usado para resolve pontos de extremidade e expandir parâmetros no modelo de rota.
- scheme
- String
O esquema de URI, aplicado ao URI resultante. Opcional. Se não for fornecido, o valor de Scheme será usado.
- host
- Nullable<HostString>
O host/autoridade de URI, aplicado ao URI resultante. Opcional. Se não for fornecido, o valor Host será usado.
- pathBase
- Nullable<PathString>
Uma base de caminho de URI opcional. Anexado ao caminho no URI resultante. Se não for fornecido, o valor de PathBase será usado.
- fragment
- FragmentString
Um fragmento de URI. Opcional. Acrescentado ao URI resultante.
- options
- LinkOptions
Um LinkOptions opcional. As configurações no objeto fornecido substituem as configurações com nomes correspondentes de RouteOptions.
Retornos
Um URI absoluto ou null se um URI não puder ser criado.
Comentários
O valor de host deve ser um valor confiável. Depender do valor da solicitação atual pode permitir que a entrada não confiável influencie o URI resultante, a menos que o Host cabeçalho tenha sido validado. Consulte a documentação de implantação para obter instruções sobre como validar corretamente o Host cabeçalho em seu ambiente de implantação.