Compartilhar via

LinkGenerator.GetUriByAddress Método

  • Referência

Definição

Namespace:
Microsoft.AspNetCore.Routing
Assembly:
Microsoft.AspNetCore.Routing.Abstractions.dll
Pacote:
Microsoft.AspNetCore.Routing.Abstractions v2.2.0
Pacote:
Microsoft.AspNetCore.App.Ref v3.0.1
Pacote:
Microsoft.AspNetCore.App.Ref v3.1.10
Pacote:
Microsoft.AspNetCore.App.Ref v5.0.0
Pacote:
Microsoft.AspNetCore.App.Ref v6.0.6
Pacote:
Microsoft.AspNetCore.App.Ref v7.0.5
Pacote:
Microsoft.AspNetCore.App.Ref v8.0.0
Pacote:
Microsoft.AspNetCore.App.Ref v9.0.0-rc.2.24474.3

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)

Origem:
LinkGenerator.cs

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

Aplica-se a

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

Origem:
LinkGenerator.cs

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

Aplica-se a