RouteCollection クラス

定義

ASP.NET ルーティングのルートのコレクションを提供します。Provides a collection of routes for ASP.NET routing.

public ref class RouteCollection : System::Collections::ObjectModel::Collection<System::Web::Routing::RouteBase ^>
public class RouteCollection : System.Collections.ObjectModel.Collection<System.Web.Routing.RouteBase>
type RouteCollection = class
    inherit Collection<RouteBase>
Public Class RouteCollection
Inherits Collection(Of RouteBase)
継承
RouteCollection

注釈

クラスRouteCollectionには、 RouteBaseクラスから派生したオブジェクトのコレクションを管理できるようにするメソッドが用意されています。The RouteCollection class provides methods that enable you to manage a collection of objects that derive from the RouteBase class.

通常は、 static RouteTableクラスのRoutesプロパティを使用してオブジェクトをRouteCollection取得します。Typically, you will use the staticRoutes property of the RouteTable class to retrieve a RouteCollection object. プロパティRoutesは、ASP.NET アプリケーションのすべてのルートを格納します。The Routes property stores all the routes for an ASP.NET application. ASP.NET ルーティングは、 Routesプロパティ内のルートを反復処理して、URL に一致するルートを検索します。ASP.NET routing iterates through the routes in the Routes property to find the route that matches a URL.

URL を作成するには、 GetVirtualPathメソッドを呼び出し、値のコレクションを渡します。To construct a URL, you call the GetVirtualPath method and pass in a collection of values. メソッドGetVirtualPathは、渡された値と一致するパラメーターを持つ最初のルートを検索し、 VirtualPathData一致するルートに関する情報を格納しているオブジェクトを返します。The GetVirtualPath method finds the first route with parameters that match the values that you passed in, and returns a VirtualPathData object that contains information about the matching route. URL は、 VirtualPathDataオブジェクトのプロパティVirtualPathを使用して取得します。You retrieve the URL through the VirtualPath property of the VirtualPathData object.

名前を使用するか、名前を付けずに、ルートを追加できます。You can add a route either with a name or without a name. 名前を含めると、Url の構築時に同様のルートを区別できます。Including a name enables you to distinguish between similar routes when URLs are constructed. 名前を指定しない場合、ASP.NET routing はコレクション内で最初に一致するルートを使用して URL を作成します。If you do not specify a name, ASP.NET routing uses the first matching route in the collection to construct a URL.

名前のRouteCollectionないルートをオブジェクトに追加した場合、既にコレクション内に存在するルートを追加することはできません。When you add an unnamed route to the RouteCollection object, you cannot add a route that already is in the collection. 名前付きルートを追加する場合、コレクション内のルートを既に識別している名前を使用することはできません。When you add a named route, you cannot use a name that already identifies a route in the collection.

GetReadLock メソッドGetWriteLockとメソッドを使用して、他のプロセスと競合することなく、コレクションとの対話を確実に行うことができます。You use the GetReadLock method and the GetWriteLock method to make sure that you interact with the collection without conflicts from other processes.

ルートコレクションにルートを追加する方法の詳細については、「 ASP.NET Routing」を参照してください。For more information about how to add a route to a route collection, see ASP.NET Routing.

コンストラクター

RouteCollection()

RouteCollection クラスの新しいインスタンスを初期化します。Initializes a new instance of the RouteCollection class.

RouteCollection(VirtualPathProvider)

指定した仮想パス プロバイダーを使用して、RouteCollection クラスの新しいインスタンスを初期化します。Initializes a new instance of the RouteCollection class by using the specified virtual path provider.

プロパティ

AppendTrailingSlash

仮想パスが正規化されるときに後続のスラッシュを追加するかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether trailing slashes are added when virtual paths are normalized.

Count

Collection<T> に実際に含まれる要素の数を取得します。Gets the number of elements actually contained in the Collection<T>.

(継承元 Collection<T>)
Item[Int32]

指定したインデックスにある要素を取得または設定します。Gets or sets the element at the specified index.

(継承元 Collection<T>)
Item[String]

指定した名前のルートをコレクションから取得します。Gets the route in the collection that has the specified name.

Items

IList<T> をラップする Collection<T> ラッパーを取得します。Gets a IList<T> wrapper around the Collection<T>.

(継承元 Collection<T>)
LowercaseUrls

仮想パスが正規化されるときに URL を小文字に変換するかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether URLs are converted to lower case when virtual paths are normalized.

RouteExistingFiles

ASP.NET ルーティングで既存のファイルと一致する URL を処理するかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether ASP.NET routing should handle URLs that match an existing file.

メソッド

Add(String, RouteBase)

RouteCollection オブジェクトの末尾にルートを追加し、指定の名前をそのルートに割り当てます。Adds a route to the end of the RouteCollection object and assigns the specified name to the route.

Add(T)

Collection<T> の末尾にオブジェクトを追加します。Adds an object to the end of the Collection<T>.

(継承元 Collection<T>)
Clear()

Collection<T> からすべての要素を削除します。Removes all elements from the Collection<T>.

(継承元 Collection<T>)
ClearItems()

RouteCollection オブジェクトからすべての要素を削除します。Removes all the elements from the RouteCollection object.

Contains(T)

ある要素が Collection<T> 内に存在するかどうかを判断します。Determines whether an element is in the Collection<T>.

(継承元 Collection<T>)
CopyTo(T[], Int32)

Collection<T> 全体を、互換性のある 1 次元の Array にコピーします。コピー操作は、コピー先の配列の指定したインデックスから始まる部分に行います。Copies the entire Collection<T> to a compatible one-dimensional Array, starting at the specified index of the target array.

(継承元 Collection<T>)
Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(継承元 Object)
GetEnumerator()

Collection<T> を反復処理する列挙子を返します。Returns an enumerator that iterates through the Collection<T>.

(継承元 Collection<T>)
GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetReadLock()

コレクションからオブジェクトを取得するときにスレッド セーフを管理するためのオブジェクトを提供します。Provides an object for managing thread safety when you retrieve an object from the collection.

GetRouteData(HttpContextBase)

指定した値と一致する、コレクション内のルートに関する情報を返します。Returns information about the route in the collection that matches the specified values.

GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
GetVirtualPath(RequestContext, RouteValueDictionary)

指定のコンテキストおよびパラメーター値に基づいて、ルートに関連付けられている URL パスに関する情報を返します。Returns information about the URL path that is associated with the route, given the specified context and parameter values.

GetVirtualPath(RequestContext, String, RouteValueDictionary)

指定のコンテキスト、ルート名、およびパラメーター値に基づいて、名前付きのルートに関連付けられている URL パスに関する情報を返します。Returns information about the URL path that is associated with the named route, given the specified context, route name, and parameter values.

GetWriteLock()

コレクションの要素を追加または削除するときにスレッド セーフを管理するためのオブジェクトを提供します。Provides an object for managing thread safety when you add or remove elements in the collection.

Ignore(String)

ルートの照合を行わない URL パターンを定義します。Defines a URL pattern that should not be checked for matches against routes.

Ignore(String, Object)

要求 URL が指定された制約に一致する場合に、ルートの照合を行わない URL パターンを定義します。Defines a URL pattern that should not be checked for matches against routes if a request URL meets the specified constraints.

IndexOf(T)

指定したオブジェクトを検索し、Collection<T> 全体内で最初に見つかった位置の 0 から始まるインデックスを返します。Searches for the specified object and returns the zero-based index of the first occurrence within the entire Collection<T>.

(継承元 Collection<T>)
Insert(Int32, T)

Collection<T> 内の指定したインデックスの位置に要素を挿入します。Inserts an element into the Collection<T> at the specified index.

(継承元 Collection<T>)
InsertItem(Int32, RouteBase)

RouteCollection オブジェクト内の指定したインデックス位置に、指定したルートを挿入します。Inserts the specified route into the RouteCollection object at the specified index.

InsertItem(Int32, T)

Collection<T> 内の指定したインデックスの位置に要素を挿入します。Inserts an element into the Collection<T> at the specified index.

(継承元 Collection<T>)
MapPageRoute(String, String, String)

Web フォーム アプリケーションのルートを定義する手段を提供します。Provides a way to define routes for Web Forms applications.

MapPageRoute(String, String, String, Boolean)

Web フォーム アプリケーションのルートを定義する手段を提供します。Provides a way to define routes for Web Forms applications.

MapPageRoute(String, String, String, Boolean, RouteValueDictionary)

Web フォーム アプリケーションのルートを定義する手段を提供します。Provides a way to define routes for Web Forms applications.

MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary)

Web フォーム アプリケーションのルートを定義する手段を提供します。Provides a way to define routes for Web Forms applications.

MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary)

Web フォーム アプリケーションのルートを定義する手段を提供します。Provides a way to define routes for Web Forms applications.

MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
Remove(T)

特定のオブジェクトが Collection<T> 内にあるときに、最初に出現したものを削除します。Removes the first occurrence of a specific object from the Collection<T>.

(継承元 Collection<T>)
RemoveAt(Int32)

Collection<T> の指定したインデックスにある要素を削除します。Removes the element at the specified index of the Collection<T>.

(継承元 Collection<T>)
RemoveItem(Int32)

RouteCollection オブジェクトから指定したインデックス位置にあるルートを削除します。Removes the route from the RouteCollection object at the specified index.

SetItem(Int32, RouteBase)

指定したインデックス位置にあるルートを置き換えます。Replaces the route at the specified index.

SetItem(Int32, T)

指定したインデックス位置にある要素を置き換えます。Replaces the element at the specified index.

(継承元 Collection<T>)
ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(継承元 Object)

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

ICollection.CopyTo(Array, Int32)

ICollection の要素を Array にコピーします。Array の特定のインデックスからコピーが開始されます。Copies the elements of the ICollection to an Array, starting at a particular Array index.

(継承元 Collection<T>)
ICollection.IsSynchronized

ICollection へのアクセスが同期されている (スレッド セーフである) かどうかを示す値を取得します。Gets a value indicating whether access to the ICollection is synchronized (thread safe).

(継承元 Collection<T>)
ICollection.SyncRoot

ICollection へのアクセスを同期するために使用できるオブジェクトを取得します。Gets an object that can be used to synchronize access to the ICollection.

(継承元 Collection<T>)
ICollection<T>.IsReadOnly

ICollection<T> が読み取り専用かどうかを示す値を取得します。Gets a value indicating whether the ICollection<T> is read-only.

(継承元 Collection<T>)
IEnumerable.GetEnumerator()

コレクションを反復処理する列挙子を返します。Returns an enumerator that iterates through a collection.

(継承元 Collection<T>)
IList.Add(Object)

IList に項目を追加します。Adds an item to the IList.

(継承元 Collection<T>)
IList.Contains(Object)

IList に特定の値が格納されているかどうかを判断します。Determines whether the IList contains a specific value.

(継承元 Collection<T>)
IList.IndexOf(Object)

IList 内の特定の項目のインデックスを確認します。Determines the index of a specific item in the IList.

(継承元 Collection<T>)
IList.Insert(Int32, Object)

IList 内の指定したインデックス位置に項目を挿入します。Inserts an item into the IList at the specified index.

(継承元 Collection<T>)
IList.IsFixedSize

IList が固定サイズかどうかを示す値を取得します。Gets a value indicating whether the IList has a fixed size.

(継承元 Collection<T>)
IList.IsReadOnly

IList が読み取り専用かどうかを示す値を取得します。Gets a value indicating whether the IList is read-only.

(継承元 Collection<T>)
IList.Item[Int32]

指定したインデックスにある要素を取得または設定します。Gets or sets the element at the specified index.

(継承元 Collection<T>)
IList.Remove(Object)

特定のオブジェクトが IList 内にあるときに、最初に出現したものを削除します。Removes the first occurrence of a specific object from the IList.

(継承元 Collection<T>)

拡張メソッド

CopyToDataTable<T>(IEnumerable<T>)

指定した入力 DataTable オブジェクトに応じて (ジェネリック パラメーター TDataRow)、IEnumerable<T> オブジェクトのコピーを格納する DataRow を返します。Returns a DataTable that contains copies of the DataRow objects, given an input IEnumerable<T> object where the generic parameter T is DataRow.

CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption)

指定した入力 DataRow オブジェクトに応じて (ジェネリック パラメーター TDataTable)、指定した IEnumerable<T>DataRow オブジェクトをコピーします。Copies DataRow objects to the specified DataTable, given an input IEnumerable<T> object where the generic parameter T is DataRow.

CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler)

指定した入力 DataRow オブジェクトに応じて (ジェネリック パラメーター TDataTable)、指定した IEnumerable<T>DataRow オブジェクトをコピーします。Copies DataRow objects to the specified DataTable, given an input IEnumerable<T> object where the generic parameter T is DataRow.

Cast<TResult>(IEnumerable)

IEnumerable の要素を、指定した型にキャストします。Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

指定された型に基づいて IEnumerable の要素をフィルター処理します。Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

クエリの並列化を有効にします。Enables parallelization of a query.

AsQueryable(IEnumerable)

IEnumerableIQueryable に変換します。Converts an IEnumerable to an IQueryable.

Ancestors<T>(IEnumerable<T>)

ソース コレクション内のすべてのノードの先祖が格納された、要素のコレクションを返します。Returns a collection of elements that contains the ancestors of every node in the source collection.

Ancestors<T>(IEnumerable<T>, XName)

ソース コレクション内のすべてのノードの先祖が格納され、フィルター処理された要素のコレクションを返します。Returns a filtered collection of elements that contains the ancestors of every node in the source collection. 一致する XName を持つ要素のみがコレクションに含められます。Only elements that have a matching XName are included in the collection.

DescendantNodes<T>(IEnumerable<T>)

ソース コレクション内のすべてのドキュメントおよび要素の子孫ノードのコレクションを返します。Returns a collection of the descendant nodes of every document and element in the source collection.

Descendants<T>(IEnumerable<T>)

ソース コレクション内のすべての要素とドキュメントの子孫要素が格納された要素のコレクションを返します。Returns a collection of elements that contains the descendant elements of every element and document in the source collection.

Descendants<T>(IEnumerable<T>, XName)

ソース コレクション内のすべての要素とドキュメントの子孫要素が格納され、フィルター処理された要素のコレクションを返します。Returns a filtered collection of elements that contains the descendant elements of every element and document in the source collection. 一致する XName を持つ要素のみがコレクションに含められます。Only elements that have a matching XName are included in the collection.

Elements<T>(IEnumerable<T>)

ソース コレクション内のすべての要素およびドキュメントの子要素のコレクションを返します。Returns a collection of the child elements of every element and document in the source collection.

Elements<T>(IEnumerable<T>, XName)

ソース コレクション内のすべての要素およびドキュメントの、フィルター処理された子要素のコレクションを返します。Returns a filtered collection of the child elements of every element and document in the source collection. 一致する XName を持つ要素のみがコレクションに含められます。Only elements that have a matching XName are included in the collection.

InDocumentOrder<T>(IEnumerable<T>)

ソース コレクション内のすべてのノードがドキュメント順に並べ替えて格納された、ノードのコレクションを返します。Returns a collection of nodes that contains all nodes in the source collection, sorted in document order.

Nodes<T>(IEnumerable<T>)

ソース コレクション内のすべてのドキュメントおよび要素の子ノードのコレクションを返します。Returns a collection of the child nodes of every document and element in the source collection.

Remove<T>(IEnumerable<T>)

ソース コレクション内の親ノードからすべてのノードを削除します。Removes every node in the source collection from its parent node.

適用対象

こちらもご覧ください