LinkGeneratorEndpointNameAddressExtensions.GetUriByName Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
GetUriByName(LinkGenerator, String, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions) |
Genera un URI absoluto en función de los valores proporcionados. |
GetUriByName(LinkGenerator, String, Object, String, HostString, PathString, FragmentString, LinkOptions) |
Genera un URI absoluto en función de los valores proporcionados. |
GetUriByName(LinkGenerator, HttpContext, String, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions) |
Genera un URI absoluto en función de los valores proporcionados. |
GetUriByName(LinkGenerator, HttpContext, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions) |
Genera un URI absoluto en función de los valores proporcionados. |
GetUriByName(LinkGenerator, String, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)
Genera un URI absoluto en función de los valores proporcionados.
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
El nombre del extremo. Se usa para resolver puntos de conexión.
- values
- RouteValueDictionary
Valores de ruta. Se usa para expandir parámetros en la plantilla de ruta.
- scheme
- String
Esquema de URI, aplicado al URI resultante.
- host
- HostString
Host o autoridad del URI, aplicado al URI resultante.
Consulte la sección de comentarios para obtener más información sobre las implicaciones de seguridad de host
.
- pathBase
- PathString
Una base de ruta de acceso de URI opcional. Anteponedo a la ruta de acceso en el URI resultante.
- fragment
- FragmentString
Un fragmento de URI opcional. Anexado al URI resultante.
- options
- LinkOptions
LinkOptions opcional. La configuración del objeto proporcionado invalida la configuración con nombres coincidentes de RouteOptions
.
Devoluciones
Un URI absoluto o null
.
Comentarios
El valor de debe ser un valor de host
confianza. Confiar en el valor de la solicitud actual puede permitir que la entrada que no sea de confianza influir en el URI resultante a menos que se haya validado el Host
encabezado. Consulte la documentación de implementación para obtener instrucciones sobre cómo validar correctamente el encabezado en el Host
entorno de implementación.
Se aplica a
GetUriByName(LinkGenerator, String, Object, String, HostString, PathString, FragmentString, LinkOptions)
Genera un URI absoluto en función de los valores proporcionados.
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
El nombre del extremo. Se usa para resolver puntos de conexión.
- values
- Object
Valores de ruta. Se usa para expandir parámetros en la plantilla de ruta. Opcional.
- scheme
- String
Esquema de URI, aplicado al URI resultante.
- host
- HostString
Host o autoridad del URI, aplicado al URI resultante.
Consulte la sección de comentarios para obtener más información sobre las implicaciones de seguridad de host
.
- pathBase
- PathString
Una base de ruta de acceso de URI opcional. Anteponedo a la ruta de acceso en el URI resultante.
- fragment
- FragmentString
Un fragmento de URI opcional. Anexado al URI resultante.
- options
- LinkOptions
LinkOptions opcional. La configuración del objeto proporcionado invalida la configuración con nombres coincidentes de RouteOptions
.
Devoluciones
Un URI absoluto o null
.
Comentarios
El valor de debe ser un valor de host
confianza. Confiar en el valor de la solicitud actual puede permitir que la entrada que no sea de confianza influir en el URI resultante a menos que se haya validado el Host
encabezado. Consulte la documentación de implementación para obtener instrucciones sobre cómo validar correctamente el encabezado en el Host
entorno de implementación.
Se aplica a
GetUriByName(LinkGenerator, HttpContext, String, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
Genera un URI absoluto en función de los valores proporcionados.
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
asociado HttpContext a la solicitud actual.
- endpointName
- String
El nombre del extremo. Se usa para resolver puntos de conexión.
- values
- RouteValueDictionary
Valores de ruta. Se usa para expandir parámetros en la plantilla de ruta. Opcional.
- scheme
- String
Esquema de URI, aplicado al URI resultante. Opcional. Si no se proporciona, se usará el valor de Scheme .
- host
- Nullable<HostString>
Host o autoridad del URI, aplicado al URI resultante. Opcional. Si no se proporciona, se usará el valor Host .
Consulte la sección de comentarios para obtener más información sobre las implicaciones de seguridad de host
.
- pathBase
- Nullable<PathString>
Una base de ruta de acceso de URI opcional. Anteponedo a la ruta de acceso en el URI resultante. Si no se proporciona, se usará el valor de PathBase .
- fragment
- FragmentString
Un fragmento de URI opcional. Anexado al URI resultante.
- options
- LinkOptions
LinkOptions opcional. La configuración del objeto proporcionado invalida la configuración con nombres coincidentes de RouteOptions
.
Devoluciones
Un URI con una ruta de acceso absoluta o null
.
Comentarios
El valor de debe ser un valor de host
confianza. Confiar en el valor de la solicitud actual puede permitir que la entrada que no sea de confianza influir en el URI resultante a menos que se haya validado el Host
encabezado. Consulte la documentación de implementación para obtener instrucciones sobre cómo validar correctamente el encabezado en el Host
entorno de implementación.
Se aplica a
GetUriByName(LinkGenerator, HttpContext, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
Genera un URI absoluto en función de los valores proporcionados.
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
asociado HttpContext a la solicitud actual.
- endpointName
- String
El nombre del extremo. Se usa para resolver puntos de conexión.
- values
- Object
Valores de ruta. Se usa para expandir parámetros en la plantilla de ruta. Opcional.
- scheme
- String
Esquema de URI, aplicado al URI resultante. Opcional. Si no se proporciona, se usará el valor de Scheme .
- host
- Nullable<HostString>
Host o autoridad del URI, aplicado al URI resultante. Opcional. Si no se proporciona, se usará el valor Host .
Consulte la sección de comentarios para obtener más información sobre las implicaciones de seguridad de host
.
- pathBase
- Nullable<PathString>
Una base de ruta de acceso de URI opcional. Anteponedo a la ruta de acceso en el URI resultante. Si no se proporciona, se usará el valor de PathBase .
- fragment
- FragmentString
Un fragmento de URI opcional. Anexado al URI resultante.
- options
- LinkOptions
LinkOptions opcional. La configuración del objeto proporcionado invalida la configuración con nombres coincidentes de RouteOptions
.
Devoluciones
Un URI con una ruta de acceso absoluta o null
.
Comentarios
El valor de debe ser un valor de host
confianza. Confiar en el valor de la solicitud actual puede permitir que la entrada que no sea de confianza influir en el URI resultante a menos que se haya validado el Host
encabezado. Consulte la documentación de implementación para obtener instrucciones sobre cómo validar correctamente el encabezado en el Host
entorno de implementación.