PageLinkGeneratorExtensions.GetUriByPage 方法

參考

定義

命名空間:: Microsoft.AspNetCore.Routing

組件:: Microsoft.AspNetCore.Mvc.Core.dll

套件:: Microsoft.AspNetCore.Mvc.Core 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 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

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)

根據提供的值產生絕對 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

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 設定。

傳回

String

絕對 URI，如果無法建立 URI，則 null 為。

備註

的值 host 應該是受信任的值。除非已驗證標頭，否則 Host 依賴目前要求的值可允許不受信任的輸入影響產生的 URI。如需如何在部署環境中正確驗證 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