LinkGeneratorRouteValuesAddressExtensions.GetUriByRouteValues メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
GetUriByRouteValues(LinkGenerator, String, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)
指定された値に基づき、絶対 URI を生成します。
public static string? GetUriByRouteValues (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string? routeName, 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);static member GetUriByRouteValues : Microsoft.AspNetCore.Routing.LinkGenerator * string * Microsoft.AspNetCore.Routing.RouteValueDictionary * string * Microsoft.AspNetCore.Http.HostString * Microsoft.AspNetCore.Http.PathString * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string<Extension()>
Public Function GetUriByRouteValues (generator As LinkGenerator, routeName As String, 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パラメーター
- generator
- LinkGenerator
- routeName
- String
ルートの名前。 エンドポイントを解決するために使用されます。 省略可能。
- values
- RouteValueDictionary
ルート値。 ルート テンプレートでエンドポイントを解決し、パラメーターを展開するために使用します。
- scheme
- String
結果の URI に適用される URI スキーム。
- host
- HostString
結果の URI に適用される URI ホスト/機関。
のセキュリティへの影響の詳細については、「解説」セクションを host参照してください。
- pathBase
- PathString
省略可能な URI パスベース。 結果の URI のパスの前に追加されます。
- fragment
- FragmentString
省略可能な URI フラグメント。 結果の URI に追加されます。
- options
- LinkOptions
オプションの LinkOptions。 指定されたオブジェクトの設定は、 の RouteOptions名前が一致する設定をオーバーライドします。
戻り値
絶対 URI または null。
注釈
の host 値は信頼できる値である必要があります。 現在の要求の値に依存すると、ヘッダーが検証されていない限り、信頼されていない入力が結果の URI に影響を Host 与える可能性があります。 デプロイ環境でヘッダーを適切に検証する方法については、 Host デプロイドキュメントを参照してください。
適用対象
GetUriByRouteValues(LinkGenerator, String, Object, String, HostString, PathString, FragmentString, LinkOptions)
指定された値に基づき、絶対 URI を生成します。
public static string GetUriByRouteValues (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string routeName, 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? GetUriByRouteValues (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string? routeName, 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 GetUriByRouteValues : Microsoft.AspNetCore.Routing.LinkGenerator * string * obj * string * Microsoft.AspNetCore.Http.HostString * Microsoft.AspNetCore.Http.PathString * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string<Extension()>
Public Function GetUriByRouteValues (generator As LinkGenerator, routeName 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
- routeName
- String
ルートの名前。 エンドポイントを解決するために使用されます。 省略可能。
- values
- Object
ルート値。 ルート テンプレートでエンドポイントを解決し、パラメーターを展開するために使用します。 省略可能。
- scheme
- String
結果の URI に適用される URI スキーム。
- host
- HostString
結果の URI に適用される URI ホスト/機関。
のセキュリティへの影響の詳細については、「解説」セクションを host参照してください。
- pathBase
- PathString
省略可能な URI パスベース。 結果の URI のパスの前に追加されます。
- fragment
- FragmentString
省略可能な URI フラグメント。 結果の URI に追加されます。
- options
- LinkOptions
オプションの LinkOptions。 指定されたオブジェクトの設定は、 の RouteOptions名前が一致する設定をオーバーライドします。
戻り値
絶対 URI または null。
注釈
の host 値は信頼できる値である必要があります。 現在の要求の値に依存すると、ヘッダーが検証されていない限り、信頼されていない入力が結果の URI に影響を Host 与える可能性があります。 デプロイ環境でヘッダーを適切に検証する方法については、 Host デプロイドキュメントを参照してください。
適用対象
GetUriByRouteValues(LinkGenerator, HttpContext, String, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
指定された値に基づき、絶対 URI を生成します。
public static string? GetUriByRouteValues (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string? routeName, Microsoft.AspNetCore.Routing.RouteValueDictionary? 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 GetUriByRouteValues : Microsoft.AspNetCore.Routing.LinkGenerator * Microsoft.AspNetCore.Http.HttpContext * string * Microsoft.AspNetCore.Routing.RouteValueDictionary * string * Nullable<Microsoft.AspNetCore.Http.HostString> * Nullable<Microsoft.AspNetCore.Http.PathString> * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string<Extension()>
Public Function GetUriByRouteValues (generator As LinkGenerator, httpContext As HttpContext, routeName As String, Optional values 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パラメーター
- generator
- LinkGenerator
- httpContext
- HttpContext
現在の HttpContext 要求に関連付けられている 。
- routeName
- String
ルートの名前。 エンドポイントを解決するために使用されます。 省略可能。
- values
- RouteValueDictionary
ルート値。 ルート テンプレートでエンドポイントを解決し、パラメーターを展開するために使用します。 省略可能。
- host
- Nullable<HostString>
結果の URI に適用される URI ホスト/機関。 省略可能。 指定しない場合は、値 Host が使用されます。
のセキュリティへの影響の詳細については、「解説」セクションを host参照してください。
- pathBase
- Nullable<PathString>
省略可能な URI パスベース。 結果の URI のパスの前に追加されます。 指定しない場合は、 の PathBase 値が使用されます。
- fragment
- FragmentString
省略可能な URI フラグメント。 結果の URI に追加されます。
- options
- LinkOptions
オプションの LinkOptions。 指定されたオブジェクトの設定は、 の RouteOptions名前が一致する設定をオーバーライドします。
戻り値
絶対パス () nullを持つ URI。
注釈
の host 値は信頼できる値である必要があります。 現在の要求の値に依存すると、ヘッダーが検証されていない限り、信頼されていない入力が結果の URI に影響を Host 与える可能性があります。 デプロイ環境でヘッダーを適切に検証する方法については、 Host デプロイドキュメントを参照してください。
適用対象
GetUriByRouteValues(LinkGenerator, HttpContext, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
指定された値に基づき、絶対 URI を生成します。
public static string GetUriByRouteValues (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string routeName, object values, 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? GetUriByRouteValues (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string? routeName, object? values, 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 GetUriByRouteValues : Microsoft.AspNetCore.Routing.LinkGenerator * Microsoft.AspNetCore.Http.HttpContext * 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 GetUriByRouteValues (generator As LinkGenerator, httpContext As HttpContext, routeName As String, values As Object, 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 要求に関連付けられている 。
- routeName
- String
ルートの名前。 エンドポイントを解決するために使用されます。 省略可能。
- values
- Object
ルート値。 ルート テンプレートでエンドポイントを解決し、パラメーターを展開するために使用します。 省略可能。
- host
- Nullable<HostString>
結果の URI に適用される URI ホスト/機関。 省略可能。 指定しない場合は、値 Host が使用されます。
のセキュリティへの影響の詳細については、「解説」セクションを host参照してください。
- pathBase
- Nullable<PathString>
省略可能な URI パスベース。 結果の URI のパスの前に追加されます。 指定しない場合は、 の PathBase 値が使用されます。
- fragment
- FragmentString
省略可能な URI フラグメント。 結果の URI に追加されます。
- options
- LinkOptions
オプションの LinkOptions。 指定されたオブジェクトの設定は、 の RouteOptions名前が一致する設定をオーバーライドします。
戻り値
絶対パス () nullを持つ URI。
注釈
の host 値は信頼できる値である必要があります。 現在の要求の値に依存すると、ヘッダーが検証されていない限り、信頼されていない入力が結果の URI に影響を Host 与える可能性があります。 デプロイ環境でヘッダーを適切に検証する方法については、 Host デプロイドキュメントを参照してください。