LinkGenerator.GetUriByAddress 方法

定义

重载

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

根据提供的值生成绝对 URI。

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

根据提供的值 和 HttpContext生成绝对 URI。

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

Source:
LinkGenerator.cs

根据提供的值生成绝对 URI。

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

类型参数

TAddress

地址类型。

参数

address
TAddress

地址值。 用于解析终结点。

values
RouteValueDictionary

路由值。 用于展开路由模板中的参数。

scheme
String

应用于生成的 URI 的 URI 方案。

host
HostString

应用于生成的 URI 的 URI 主机/颁发机构。 有关 的安全影响 host的详细信息,请参阅备注部分。

pathBase
PathString

可选的 URI 路径基。 在生成的 URI 中追加到路径的前面。

fragment
FragmentString

可选的 URI 片段。 追加到生成的 URI。

options
LinkOptions

一个可选的 LinkOptions。 提供的 对象上的设置将替代具有匹配名称的设置 RouteOptions

返回

绝对 URI 或 null

注解

的值 host 应为受信任的值。 依赖当前请求的值可能会允许不受信任的输入影响生成的 URI, Host 除非标头已经过验证。 有关如何在部署环境中正确验证标头的说明, Host 请参阅部署文档。

适用于

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

Source:
LinkGenerator.cs

根据提供的值 和 HttpContext生成绝对 URI。

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

类型参数

TAddress

地址类型。

参数

httpContext
HttpContext

HttpContext 当前请求关联的 。

address
TAddress

地址值。 用于解析终结点。

values
RouteValueDictionary

路由值。 用于展开路由模板中的参数。

ambientValues
RouteValueDictionary

与当前请求关联的值。 可选。

scheme
String

应用于生成的 URI 的 URI 方案。 可选。 如果未提供,将使用 的值 Scheme

host
Nullable<HostString>

应用于生成的 URI 的 URI 主机/颁发机构。 可选。 如果未提供,将使用 值 Host 。 有关 的安全影响 host的详细信息,请参阅备注部分。

pathBase
Nullable<PathString>

可选的 URI 路径基。 在生成的 URI 中追加到路径的前面。 如果未提供,将使用 的值 PathBase

fragment
FragmentString

可选的 URI 片段。 追加到生成的 URI。

options
LinkOptions

一个可选的 LinkOptions。 提供的 对象上的设置将替代具有匹配名称的设置 RouteOptions

返回

具有绝对路径的 URI 或 null

注解

的值 host 应为受信任的值。 依赖当前请求的值可能会允许不受信任的输入影响生成的 URI, Host 除非标头已经过验证。 有关如何在部署环境中正确验证标头的说明, Host 请参阅部署文档。

适用于