通过

LinkGenerator.GetUriByAddress 方法

  • 参考

定义

命名空间:
Microsoft.AspNetCore.Routing
程序集:
Microsoft.AspNetCore.Routing.Abstractions.dll
包:
Microsoft.AspNetCore.Routing.Abstractions v2.2.0
包:
Microsoft.AspNetCore.App.Ref v3.0.1
包:
Microsoft.AspNetCore.App.Ref v3.1.10
包:
Microsoft.AspNetCore.App.Ref v5.0.0
包:
Microsoft.AspNetCore.App.Ref v6.0.6
包:
Microsoft.AspNetCore.App.Ref v7.0.5
包:
Microsoft.AspNetCore.App.Ref v8.0.0
包:
Microsoft.AspNetCore.App.Ref v9.0.0-rc.2.24474.3

重载

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。

返回

String

绝对 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。

返回

String

具有绝对路径的 URI 或 null。

注解

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

适用于