RouteParameter クラス

リファレンス

定義

名前空間:: System.Web.UI.WebControls

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

URL セグメントの値をパラメーターオブジェクトにバインドします。

public ref class RouteParameter : System::Web::UI::WebControls::Parameter

public class RouteParameter : System.Web.UI.WebControls.Parameter

type RouteParameter = class
    inherit Parameter

Public Class RouteParameter
Inherits Parameter

継承: Object

Parameter
RouteParameter

例

このセクションの例では、マークアップ内のオブジェクトを使用 RouteParameter して、データソースコントロールに指定されたクエリに URL パラメーター値を渡す方法を示します。

次の例は、という名前 ProductRouteのルートを定義する Global.asax ページのコードを示しています。ルートは、という名前 productnameの URL パラメーターを定義します。また、このルートでは、という名前 cultureの省略可能な catchall パラメーターも定義されています。これは、製品の説明を表示する言語を指定するために使用できます。 [Product.aspx] ページは、このルートの要求を処理します。

次の例は、Product.aspx ページを示しています。ページには、2 つのパラメーターを必要とするクエリを含むコントロールが含まれています SqlDataSource 。1 つは製品の名前用、もう 1 つは製品の説明の言語用です。 RouteParameter オブジェクトは、クエリパラメーターの値を指定するために使用されます。ルート URL パラメーター productname の値は、クエリパラメーター @productnameに渡されます。ルート URL パラメーター culture の値は、クエリパラメーター @cultureに渡されます。ルート URL に URL パラメーター cultureが含まれていない場合は、既定値の "en" が使用されます。

次の例は、ProductLinks.aspxという名前のページを示しています。このページには、ルート URL を使用してProduct.aspx ページにリンクするハイパーリンクが含まれています。これらのハイパーリンクでは、式を使用 RouteUrl してルート URL を作成します。最初のリンクにはルートパラメーターは culture 含まれません。したがって、クエリパラメーターのオブジェクト@cultureでRouteParameter定義されている既定値 "en" がクエリで使用されます。 2 番目のリンクでは、"fr" という値が提供 culture されます。これにより、説明がフランス語で表示されます。式の使用方法 RouteUrl の詳細については、「方法: ルートから URL を構築する」を参照してください。

最初のハイパーリンクをクリックすると、コントロールに次の値が含まれるProduct.aspx ページが GridView 表示されます。

ProductID	名前	説明
`994`	`LL Bottom Bracket`	`Chromoly steel.`

2 番目のハイパーリンクをクリックすると、コントロールに次の値が GridView 表示されます。

ProductID	名前	説明
`994`	`LL Bottom Bracket`	`Acier chromé.`

この例を実行するには、2 つの.aspx ページと Global.asax ファイル内のコードを、AdventureWorksLT データベースのという名前 AdventureWorksLTConnectionString の接続文字列を定義する ASP.NET Web サイトまたは Web アプリケーションに追加します。 AdventureWorksLT データベースへの接続を設定する方法については、「 How to: Set up an AdventureWorksLT Sample Database for ASP.NET Development」を参照してください。

ASP.NET ルーティングの詳細については、「ルーティングの ASP.NET」を参照してください。

注釈

Web サイト ASP.NET ルーティングを実装する場合は、オブジェクトを RouteParameter 使用して、要求された URL のセグメントの値をデータベースクエリまたはコマンドにバインドできます。データソースコントロールまたはコントロールのマークアップでオブジェクトをQueryExtender宣言RouteParameterできます。

ソースコードを含む Visual Studio Web サイトプロジェクトは、「ダウンロード」のトピックに付属しています。

コンストラクター

RouteParameter()	RouteParameter クラスの新しいインスタンスを初期化します。
RouteParameter(RouteParameter)	指定したインスタンスの値を使用して、RouteParameter クラスの新しいインスタンスを初期化します。
RouteParameter(String, DbType, String)	指定したパラメーターの名前とデータベース型を使用し、さらに指定したルートデータのキーを使用して、RouteParameter クラスの新しいインスタンスを初期化します。
RouteParameter(String, String)	指定したパラメーターの名前を使用し、さらに指定したルートデータのキーを使用して、RouteParameter クラスの新しいインスタンスを初期化します。
RouteParameter(String, TypeCode, String)	指定したパラメーターの名前と型を使用し、さらに指定したルートデータのキーを使用して、RouteParameter クラスの新しいインスタンスを初期化します。

プロパティ

ConvertEmptyStringToNull	Parameter オブジェクトのバインド先の値が Empty の場合に、その値を `null` に変換する必要があるかどうかを示す値を取得または設定します。 (継承元 Parameter)
DbType	パラメーターのデータベース型を取得または設定します。 (継承元 Parameter)
DefaultValue	パラメーターの既定値を指定します。Evaluate(HttpContext, Control) メソッドの呼び出し時に、パラメーターはこの値にバインドされ、初期化前の状態に戻されます。 (継承元 Parameter)
Direction	Parameter オブジェクトを使用して値をコントロールにバインドするかどうか、またはそのコントロールを使用して値を変更できるかどうかを示します。 (継承元 Parameter)
IsTrackingViewState	Parameter オブジェクトがビューステートへの変更を保存しているかどうかを示す値を取得します。 (継承元 Parameter)
Name	パラメーターの名前を取得または設定します。 (継承元 Parameter)
RouteKey	ルートのパラメーターの値が取得されるルートセグメントの名前を取得または設定します。
Size	パラメーターのサイズを取得または設定します。 (継承元 Parameter)
Type	パラメーターの型を取得または設定します。 (継承元 Parameter)
ViewState	同一のページに対する複数の要求にわたって、Parameter オブジェクトのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。 (継承元 Parameter)

メソッド

Clone()	現在の RouteParameter インスタンスの複製を返します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
Evaluate(HttpContext, Control)	要求 URL を評価し、パラメーターの値を返します。
GetDatabaseType()	現在の DbType インスタンスの CLR 型と等価な Parameter 値を取得します。 (継承元 Parameter)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
LoadViewState(Object)	データソースビューの、以前保存したビューステートを復元します。 (継承元 Parameter)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
OnParameterChanged()	OnParametersChanged(EventArgs) オブジェクトを格納する ParameterCollection コレクションの Parameter メソッドを呼び出します。 (継承元 Parameter)
SaveViewState()	ページがサーバーにポストバックされた時間以降に発生した、Parameter オブジェクトのビューステートへの変更を保存します。 (継承元 Parameter)
SetDirty()	Parameter オブジェクトの状態がビューステートで記録されるように、このオブジェクトをマークします。 (継承元 Parameter)
ToString()	このインスタンスの値を、それと等価の文字列形式に変換します。 (継承元 Parameter)
TrackViewState()	Parameter オブジェクトがビューステートの変更を追跡するようにします。それにより、変更をコントロールの ViewState オブジェクトに格納して、同じページに対する複数の要求にわたって永続化できます。 (継承元 Parameter)

明示的なインターフェイスの実装

ICloneable.Clone()	現在の Parameter インスタンスの複製を返します。 (継承元 Parameter)
IStateManager.IsTrackingViewState	Parameter オブジェクトがビューステートへの変更を保存しているかどうかを示す値を取得します。 (継承元 Parameter)
IStateManager.LoadViewState(Object)	データソースビューの、以前保存したビューステートを復元します。 (継承元 Parameter)
IStateManager.SaveViewState()	ページがサーバーにポストバックされた時間以降に発生した、Parameter オブジェクトのビューステートへの変更を保存します。 (継承元 Parameter)
IStateManager.TrackViewState()	Parameter オブジェクトがビューステートの変更を追跡するようにします。それにより、変更をコントロールの ViewState オブジェクトに格納して、同じページに対する複数の要求にわたって永続化できます。 (継承元 Parameter)

適用対象

次の方法で共有