RouteValueDictionary 建構函式

定義

命名空間:

System.Web.Routing

組件:

System.Web.dll

初始化 RouteValueDictionary 類別的新執行個體。

多載

RouteValueDictionary()	初始化 RouteValueDictionary 類別的新執行個體，這個執行個體是空白的。
RouteValueDictionary(IDictionary<String,Object>)	初始化 RouteValueDictionary 類別的新執行個體，並自指定集合加入項目。
RouteValueDictionary(Object)	初始化 RouteValueDictionary 類別的新執行個體，並根據所指定物件的屬性來加入值。

RouteValueDictionary()

初始化 RouteValueDictionary 類別的新執行個體，這個執行個體是空白的。

public:
 RouteValueDictionary();

public RouteValueDictionary ();

Public Sub New ()

備註

您可以藉由呼叫 Add 方法，將專案新增至 RouteValueDictionary 物件。

另請參閱

• ASP.NET 路由

RouteValueDictionary(IDictionary<String,Object>)

初始化 RouteValueDictionary 類別的新執行個體，並自指定集合加入項目。

public:
 RouteValueDictionary(System::Collections::Generic::IDictionary<System::String ^, System::Object ^> ^ dictionary);

public RouteValueDictionary (System.Collections.Generic.IDictionary<string,object> dictionary);

new System.Web.Routing.RouteValueDictionary : System.Collections.Generic.IDictionary<string, obj> -> System.Web.Routing.RouteValueDictionary

Public Sub New (dictionary As IDictionary(Of String, Object))

參數

dictionary

IDictionary<String,Object>

項目複製到新集合的集合。

例外狀況

ArgumentNullException

dictionary 為 null。

ArgumentException

dictionary 包含一或多個重複的索引鍵。

備註

物件中的每個索引鍵都必須是唯一的 RouteValueDictionary 。 類別 RouteValueDictionary 使用不區分大小寫的序數比較。 如需詳細資訊，請參閱OrdinalIgnoreCase。 索引鍵不可以是 null。

另請參閱

• ASP.NET 路由

RouteValueDictionary(Object)

初始化 RouteValueDictionary 類別的新執行個體，並根據所指定物件的屬性來加入值。

public:
 RouteValueDictionary(System::Object ^ values);

public RouteValueDictionary (object values);

new System.Web.Routing.RouteValueDictionary : obj -> System.Web.Routing.RouteValueDictionary

Public Sub New (values As Object)

參數

values

Object

物件，包含將加入為新集合之項目的屬性。

範例

下列範例示範如何建立 Route 物件，以及如何設定 Constraints、 DataTokens和 Defaults 屬性。

void Application_Start(object sender, EventArgs e) 
{
    RegisterRoutes(RouteTable.Routes);
}

public static void RegisterRoutes(RouteCollection routes)
{
    Route reportRoute = new Route("{locale}/{year}", new ReportRouteHandler());
    reportRoute.Defaults = new RouteValueDictionary { { "locale", "en-US" }, { "year", DateTime.Now.Year.ToString() } };
    reportRoute.Constraints = new RouteValueDictionary { { "locale", "[a-z]{2}-[a-z]{2}" }, { "year", @"\d{4}" } };
    reportRoute.DataTokens = new RouteValueDictionary { { "format", "short" } };
    routes.Add(reportRoute);
}

Sub Application_Start(ByVal sender As Object, ByVal e As EventArgs)
    RegisterRoutes(RouteTable.Routes)
End Sub

Shared Sub RegisterRoutes(ByVal routes As RouteCollection)
    Dim urlPattern As String
    Dim reportRoute As Route
    
    urlPattern = "{locale}/{year}"
    
    reportRoute = New Route(urlPattern, New ReportRouteHandler)
    reportRoute.Defaults = New RouteValueDictionary(New With {.locale = "en-US", .year = DateTime.Now.Year.ToString()})
    reportRoute.Constraints = New RouteValueDictionary(New With {.locale = "[a-z]{2}-[a-z]{2}", .year = "\d{4}"})
    reportRoute.DataTokens = New RouteValueDictionary(New With {.format = "short"})

    routes.Add(reportRoute)
End Sub

備註

物件中的每個索引鍵都必須根據字典的相等比較子是唯一 RouteValueDictionary 的。 類別 RouteValueDictionary 使用不區分大小寫的序數比較。 如需詳細資訊，請參閱OrdinalIgnoreCase。 索引鍵不可以是 null。

另請參閱

• ASP.NET 路由