LinkGeneratorEndpointNameAddressExtensions.GetUriByName Método
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.
GetUriByName(LinkGenerator, String, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions) |
Gera um URI absoluto com base nos valores fornecidos. |
GetUriByName(LinkGenerator, String, Object, String, HostString, PathString, FragmentString, LinkOptions) |
Gera um URI absoluto com base nos valores fornecidos. |
GetUriByName(LinkGenerator, HttpContext, String, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions) |
Gera um URI absoluto com base nos valores fornecidos. |
GetUriByName(LinkGenerator, HttpContext, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions) |
Gera um URI absoluto com base nos valores fornecidos. |
GetUriByName(LinkGenerator, String, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)
Gera um URI absoluto com base nos valores fornecidos.
public static string? GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string endpointName, 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);
static member GetUriByName : Microsoft.AspNetCore.Routing.LinkGenerator * string * Microsoft.AspNetCore.Routing.RouteValueDictionary * string * Microsoft.AspNetCore.Http.HostString * Microsoft.AspNetCore.Http.PathString * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string
<Extension()>
Public Function GetUriByName (generator As LinkGenerator, endpointName As String, 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
- generator
- LinkGenerator
- endpointName
- String
O nome do ponto de extremidade. 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 do URI, aplicado ao URI resultante.
Consulte a seção 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
Um URI absoluto, ou null
.
Comentários
O valor de host
deve ser um valor confiável. Confiar no 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
GetUriByName(LinkGenerator, String, Object, String, HostString, PathString, FragmentString, LinkOptions)
Gera um URI absoluto com base nos valores fornecidos.
public static string GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string endpointName, 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? GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string endpointName, 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 GetUriByName : Microsoft.AspNetCore.Routing.LinkGenerator * string * obj * string * Microsoft.AspNetCore.Http.HostString * Microsoft.AspNetCore.Http.PathString * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string
<Extension()>
Public Function GetUriByName (generator As LinkGenerator, endpointName 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
- endpointName
- String
O nome do ponto de extremidade. Usado para resolve pontos de extremidade.
- values
- Object
Os valores de rota. Usado para expandir parâmetros no modelo de rota. Opcional.
- scheme
- String
O esquema de URI, aplicado ao URI resultante.
- host
- HostString
O host/autoridade do URI, aplicado ao URI resultante.
Consulte a seção 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
Um URI absoluto, ou null
.
Comentários
O valor de host
deve ser um valor confiável. Confiar no 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
GetUriByName(LinkGenerator, HttpContext, String, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
Gera um URI absoluto com base nos valores fornecidos.
public static string? GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string endpointName, Microsoft.AspNetCore.Routing.RouteValueDictionary? 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 GetUriByName : Microsoft.AspNetCore.Routing.LinkGenerator * Microsoft.AspNetCore.Http.HttpContext * string * Microsoft.AspNetCore.Routing.RouteValueDictionary * string * Nullable<Microsoft.AspNetCore.Http.HostString> * Nullable<Microsoft.AspNetCore.Http.PathString> * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string
<Extension()>
Public Function GetUriByName (generator As LinkGenerator, httpContext As HttpContext, endpointName As String, Optional values 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
- generator
- LinkGenerator
- httpContext
- HttpContext
O HttpContext associado à solicitação atual.
- endpointName
- String
O nome do ponto de extremidade. Usado para resolve pontos de extremidade.
- values
- RouteValueDictionary
Os valores de rota. Usado para expandir parâmetros no modelo de rota. 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 do URI, aplicado ao URI resultante. Opcional. Se não for fornecido, o valor Host será usado.
Consulte a seção 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
Um URI com um caminho absoluto, ou null
.
Comentários
O valor de host
deve ser um valor confiável. Confiar no 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
GetUriByName(LinkGenerator, HttpContext, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
Gera um URI absoluto com base nos valores fornecidos.
public static string GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string endpointName, object values, 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? GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string endpointName, object? values, 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 GetUriByName : Microsoft.AspNetCore.Routing.LinkGenerator * Microsoft.AspNetCore.Http.HttpContext * 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 GetUriByName (generator As LinkGenerator, httpContext As HttpContext, endpointName As String, values As Object, 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
- httpContext
- HttpContext
O HttpContext associado à solicitação atual.
- endpointName
- String
O nome do ponto de extremidade. Usado para resolve pontos de extremidade.
- values
- Object
Os valores de rota. Usado para expandir parâmetros no modelo de rota. 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 do URI, aplicado ao URI resultante. Opcional. Se não for fornecido, o valor Host será usado.
Consulte a seção 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
Um URI com um caminho absoluto, ou null
.
Comentários
O valor de host
deve ser um valor confiável. Confiar no 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.