LinkGenerator.GetUriByAddress 方法

定义

命名空间:

Microsoft.AspNetCore.Routing

程序集:

Microsoft.AspNetCore.Routing.Abstractions.dll

包:

Microsoft.AspNetCore.App.Ref v8.0.0

重载

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)

根据提供的值生成绝对 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);

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)

根据提供的值 和 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);

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 请参阅部署文档。