PageLinkGeneratorExtensions.GetUriByPage 方法

定义

重载

GetUriByPage(LinkGenerator, String, String, Object, String, HostString, PathString, FragmentString, LinkOptions)

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

GetUriByPage(LinkGenerator, HttpContext, String, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)

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

GetUriByPage(LinkGenerator, String, String, Object, String, HostString, PathString, FragmentString, LinkOptions)

Source:
PageLinkGeneratorExtensions.cs

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

参数

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)

Source:
PageLinkGeneratorExtensions.cs

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

参数

httpContext
HttpContext

HttpContext与当前请求关联的 。

page
String

页名称。 用于解析终结点。 可选。 如果 null 提供 ,则将使用当前页路由值。

handler
String

页面处理程序名称。 用于解析终结点。 可选。

values
Object

路由值。 可选。 用于解析路由模板中的终结点和展开参数。

scheme
String

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

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

适用于