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