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)

適用於

另請參閱