LinkGenerator.GetUriByAddress Método

Definição

Namespace:

Microsoft.AspNetCore.Routing

Assembly:

Microsoft.AspNetCore.Routing.Abstractions.dll

Pacote:

Microsoft.AspNetCore.App.Ref v8.0.0

Sobrecargas

GetUriByAddress<TAddress>(TAddress, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)	Gera um URI absoluto com base nos valores fornecidos.
GetUriByAddress<TAddress>(HttpContext, TAddress, RouteValueDictionary, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)	Gera um URI absoluto com base nos valores fornecidos e HttpContext.

GetUriByAddress<TAddress>(TAddress, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)

Gera um URI absoluto com base nos valores fornecidos.

public abstract string? GetUriByAddress<TAddress> (TAddress address, Microsoft.AspNetCore.Routing.RouteValueDictionary 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);

abstract member GetUriByAddress : 'Address * Microsoft.AspNetCore.Routing.RouteValueDictionary * string * Microsoft.AspNetCore.Http.HostString * Microsoft.AspNetCore.Http.PathString * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string

Public MustOverride Function GetUriByAddress(Of TAddress) (address As TAddress, values As RouteValueDictionary, 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 de tipo

TAddress

O tipo de endereço.

Parâmetros

address

TAddress

O valor do endereço. Usado para resolve pontos de extremidade.

values

RouteValueDictionary

Os valores de rota. Usado para 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. Consulte a seção de comentários para obter detalhes sobre as implicações de segurança do host.

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.

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.

GetUriByAddress<TAddress>(HttpContext, TAddress, RouteValueDictionary, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)

Gera um URI absoluto com base nos valores fornecidos e HttpContext.

public abstract string? GetUriByAddress<TAddress> (Microsoft.AspNetCore.Http.HttpContext httpContext, TAddress address, Microsoft.AspNetCore.Routing.RouteValueDictionary values, Microsoft.AspNetCore.Routing.RouteValueDictionary? ambientValues = 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);

abstract member GetUriByAddress : Microsoft.AspNetCore.Http.HttpContext * 'Address * Microsoft.AspNetCore.Routing.RouteValueDictionary * Microsoft.AspNetCore.Routing.RouteValueDictionary * string * Nullable<Microsoft.AspNetCore.Http.HostString> * Nullable<Microsoft.AspNetCore.Http.PathString> * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string

Public MustOverride Function GetUriByAddress(Of TAddress) (httpContext As HttpContext, address As TAddress, values As RouteValueDictionary, Optional ambientValues As RouteValueDictionary = 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 de tipo

TAddress

O tipo de endereço.

Parâmetros

httpContext

HttpContext

O HttpContext associado à solicitação atual.

address

TAddress

O valor do endereço. Usado para resolve pontos de extremidade.

values

RouteValueDictionary

Os valores de rota. Usado para expandir parâmetros no modelo de rota.

ambientValues

RouteValueDictionary

Os valores associados à solicitação atual. Opcional.

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. Consulte a seção de comentários para obter detalhes sobre as implicações de segurança do host.

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 com um caminho absoluto ou null.

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.