PageLinkGeneratorExtensions.GetUriByPage Método

Definição

Namespace:

Microsoft.AspNetCore.Routing

Assembly:

Microsoft.AspNetCore.Mvc.Core.dll

Pacote:

Microsoft.AspNetCore.App.Ref v8.0.0

Sobrecargas

GetUriByPage(LinkGenerator, String, String, Object, String, HostString, PathString, FragmentString, LinkOptions)	Gera um URI absoluto com base nos valores fornecidos.
GetUriByPage(LinkGenerator, HttpContext, String, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)	Gera um URI absoluto com base nos valores fornecidos.

GetUriByPage(LinkGenerator, String, String, Object, String, HostString, PathString, FragmentString, LinkOptions)

Gera um URI absoluto com base nos valores fornecidos.

public static string? GetUriByPage (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string page, string? handler, 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 GetUriByPage : 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 GetUriByPage (generator As LinkGenerator, page As String, handler 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.

page

String

O nome da página. Usado para resolve pontos de extremidade.

handler

String

O nome do manipulador de página. Pode ser nulo.

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.

GetUriByPage(LinkGenerator, HttpContext, String, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)

Gera um URI absoluto com base nos valores fornecidos.

public static string? GetUriByPage (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string? page = default, string? handler = 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 GetUriByPage : 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 GetUriByPage (generator As LinkGenerator, httpContext As HttpContext, Optional page As String = Nothing, Optional handler 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.

page

String

O nome da página. Usado para resolve pontos de extremidade. Opcional. Se null for fornecido, o valor da rota da página atual será usado.

handler

String

O nome do manipulador de página. Usado para resolve pontos de extremidade. Opcional.

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.