ControllerLinkGeneratorExtensions.GetUriByAction Método

Definição

Namespace:

Microsoft.AspNetCore.Routing

Assembly:

Microsoft.AspNetCore.Mvc.Core.dll

Pacote:

Microsoft.AspNetCore.App.Ref v8.0.0

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);

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 String

Parâmetros

generator

LinkGenerator

O 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

String

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.

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);

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 String

Parâmetros

generator

LinkGenerator

O 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

String

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.