PageLinkGeneratorExtensions.GetUriByPage 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
| 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);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 StringParâmetros
- generator
- 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
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
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);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 StringParâmetros
- generator
- 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
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.