RouteParameter 類別

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.dll

將 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 參數值傳遞至為數據源控件指定的查詢。

下列範例顯示 Global.asax 頁面中的程式代碼，定義名為 ProductRoute的路由。 路由會定義名為 productname的 URL 參數。 路由也會定義名為 culture的選擇性 catchall 參數，可用來指定顯示產品描述的語言。 Product.aspx頁面會處理此路由的要求。

下列範例顯示 [Product.aspx] 頁面。 頁面包含的控件具有需要兩個 SqlDataSource 參數的查詢，一個用於產品名稱，另一個用於產品描述的語言。 RouteParameter 對象可用來提供查詢參數的值。 路由 URL 參數 productname 的值會傳遞至查詢參數 @productname。 路由 URL 參數 culture 的值會傳遞至查詢參數 @culture。 如果路由 URL 不包含 URL 參數 culture，則會使用預設值 「en」。

下列範例顯示名為 ProductLinks.aspx 的頁面，其中包含使用路由URL連結至Product.aspx頁面的超連結。 這些超連結會使用 RouteUrl 表達式來建立路由URL。 第一個 culture 連結不包含路由參數。 因此，查詢參數物件@culture中RouteParameter定義的預設值 「en」 將會用於查詢中。 第二個 culture 連結提供 「fr」 的值，這會導致描述以法文顯示。 如需如何使用 RouteUrl 表達式的詳細資訊，請參閱 如何：從路由建構 URL。

當您按下第一個超連結時，您會看到控件中 GridView 具有下列值的 Product.aspx 頁面：

ProductID	名稱	描述
994	LL Bottom Bracket	Chromoly steel.

當您按下第二個超連結時，您會在控制項中看到 GridView 下列值：

ProductID	名稱	描述
994	LL Bottom Bracket	Acier chromé.

若要執行此範例，請將 Global.asax 檔案中的兩個.aspx頁和程式代碼新增至 ASP.NET 網站或 Web 應用程式，以定義 AdventureWorksLT 資料庫的連接字元串 AdventureWorksLTConnectionString 。 如需如何設定 AdventureWorksLT 資料庫連線的詳細資訊，請參閱 如何：設定 AdventureWorksLT 範例資料庫以進行 ASP.NET 開發。

如需 ASP.NET 路由的詳細資訊，請參閱 ASP.NET 路由。

備註

如果您在網站中實作 ASP.NET 路由，您可以使用 RouteParameter 物件，將所要求URL區段的值系結至資料庫查詢或命令。 您可以在資料來源控制件或控制的QueryExtender標記中宣告 RouteParameter 物件。

有原始程式碼的 Visual Studio 網站專案可隨附本主題： 下載。

建構函式

RouteParameter()	初始化 RouteParameter 類別的新執行個體。
RouteParameter(RouteParameter)	使用指定的執行個體值，初始化 RouteParameter 類別的新執行個體。
RouteParameter(String, DbType, String)	使用指定的參數名稱和資料庫類型，以及使用指定的路由資料索引鍵，初始化 RouteParameter 類別的新執行個體。
RouteParameter(String, String)	使用指定的參數名稱以及指定的路由資料索引鍵，初始化 RouteParameter 類別的新執行個體。
RouteParameter(String, TypeCode, String)	使用指定的參數名稱和型別，以及使用指定的路由資料索引鍵，初始化 RouteParameter 類別的新執行個體。

屬性

ConvertEmptyStringToNull	取得或設定值，該值指示是否應將 Parameter 物件繫結至的值轉換成 null (如果其為 Empty)。 (繼承來源 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 值，該值等於目前 Parameter 執行個體的 CLR 型別。 (繼承來源 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)

另請參閱

• QueryExtender
• QueryExtender Web 伺服器控制項概觀