PageLinkGeneratorExtensions.GetUriByPage 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
GetUriByPage(LinkGenerator, String, String, Object, String, HostString, PathString, FragmentString, LinkOptions)
根据提供的值生成绝对 URI。
public static string GetUriByPage (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string page, string handler, 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? GetUriByPage (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string page, string? handler, 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 GetUriByPage : Microsoft.AspNetCore.Routing.LinkGenerator * string * string * obj * string * Microsoft.AspNetCore.Http.HostString * Microsoft.AspNetCore.Http.PathString * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string
<Extension()>
Public Function GetUriByPage (generator As LinkGenerator, page As String, handler 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
参数
- generator
- LinkGenerator
- page
- String
页名称。 用于解析终结点。
- handler
- String
页面处理程序名称。 可能为 null。
- values
- Object
路由值。 可能为 null。 用于解析路由模板中的终结点和展开参数。
- scheme
- String
URI 方案,应用于生成的 URI。
- host
- HostString
应用于生成的 URI 的 URI 主机/颁发机构。
- pathBase
- PathString
可选的 URI 路径基。 追加到生成的 URI 中的路径前面。
- fragment
- FragmentString
URI 片段。 可选。 追加到生成的 URI。
- options
- LinkOptions
一个可选的 LinkOptions。 提供的 对象上的设置将覆盖具有匹配名称的设置 RouteOptions
。
返回
绝对 URI;如果无法创建 URI, null
则为 。
注解
的值 host
应为受信任的值。 依赖当前请求的值可能会允许不受信任的输入影响生成的 URI, Host
除非标头已经过验证。 有关如何在部署环境中正确验证标头的说明, Host
请参阅部署文档。
适用于
GetUriByPage(LinkGenerator, HttpContext, String, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
根据提供的值生成绝对 URI。
public static string GetUriByPage (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string page = default, string handler = default, object 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);
public static string? GetUriByPage (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string? page = default, string? handler = default, object? 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 GetUriByPage : Microsoft.AspNetCore.Routing.LinkGenerator * Microsoft.AspNetCore.Http.HttpContext * string * 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 GetUriByPage (generator As LinkGenerator, httpContext As HttpContext, Optional page As String = Nothing, Optional handler As String = Nothing, Optional values As Object = 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
参数
- generator
- LinkGenerator
- httpContext
- HttpContext
HttpContext与当前请求关联的 。
- page
- String
页名称。 用于解析终结点。 可选。 如果 null
提供 ,则将使用当前页路由值。
- handler
- String
页面处理程序名称。 用于解析终结点。 可选。
- values
- Object
路由值。 可选。 用于解析路由模板中的终结点和展开参数。
- host
- Nullable<HostString>
应用于生成的 URI 的 URI 主机/颁发机构。 可选。 如果未提供,则将使用 值 Host 。
- pathBase
- Nullable<PathString>
可选的 URI 路径基。 追加到生成的 URI 中的路径前面。 如果未提供,将使用 的值 PathBase 。
- fragment
- FragmentString
URI 片段。 可选。 追加到生成的 URI。
- options
- LinkOptions
一个可选的 LinkOptions。 提供的 对象上的设置将覆盖具有匹配名称的设置 RouteOptions
。
返回
绝对 URI;如果无法创建 URI, null
则为 。
注解
的值 host
应为受信任的值。 依赖当前请求的值可能会允许不受信任的输入影响生成的 URI, Host
除非标头已经过验证。 有关如何在部署环境中正确验证标头的说明, Host
请参阅部署文档。