RouteValueDictionary Klasa

Definicja

Reprezentuje niezależną od wielkości literę par klucz/wartość, które są używane w różnych miejscach w strukturze routingu, na przykład podczas definiowania wartości domyślnych dla trasy lub generowania adresu URL opartego na trasie.Represents a case-insensitive collection of key/value pairs that you use in various places in the routing framework, such as when you define the default values for a route or when you generate a URL that is based on a route.

public ref class RouteValueDictionary : System::Collections::Generic::ICollection<System::Collections::Generic::KeyValuePair<System::String ^, System::Object ^>>, System::Collections::Generic::IDictionary<System::String ^, System::Object ^>, System::Collections::Generic::IEnumerable<System::Collections::Generic::KeyValuePair<System::String ^, System::Object ^>>
public class RouteValueDictionary : System.Collections.Generic.ICollection<System.Collections.Generic.KeyValuePair<string,object>>, System.Collections.Generic.IDictionary<string,object>, System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<string,object>>
type RouteValueDictionary = class
    interface IDictionary<string, obj>
    interface ICollection<KeyValuePair<string, obj>>
    interface seq<KeyValuePair<string, obj>>
    interface IEnumerable
Public Class RouteValueDictionary
Implements ICollection(Of KeyValuePair(Of String, Object)), IDictionary(Of String, Object), IEnumerable(Of KeyValuePair(Of String, Object))
Dziedziczenie
RouteValueDictionary
Implementuje

Przykłady

Poniższy Route przykład pokazuje Constraints, jak utworzyć obiekt i jak ustawić właściwości, DataTokens, i Defaults .The following example shows how to create a Route object and how to set the Constraints, DataTokens, and Defaults properties.

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

Uwagi

RouteValueDictionary Klasa umożliwia pracy z kolekcjami par klucz/wartość, które są wymagane, aby można było używać routingu ASP.NET.The RouteValueDictionary class enables you to work with collections of key/value pairs that are required in order to use ASP.NET routing. RouteValueDictionary Obiekt służy do definiowania wartości Constraintswłaściwości, DataTokensi Defaults .You use the RouteValueDictionary object to define values for the Constraints, DataTokens, and Defaults properties. Podczas generowania adresu URL RouteValueDictionary należy również użyć obiektu, GetVirtualPath wywołując metodę i przekazując RouteValueDictionary obiekt jako parametr.You also use a RouteValueDictionary object when you generate a URL by calling the GetVirtualPath method and passing a RouteValueDictionary object as a parameter.

Każdy klucz w RouteValueDictionary obiekcie musi być unikatowy.Every key in a RouteValueDictionary object must be unique. RouteValueDictionary Klasa używa porównania porządkowego bez uwzględniania wielkości liter.The RouteValueDictionary class uses case-insensitive ordinal comparison. Aby uzyskać więcej informacji, zobacz OrdinalIgnoreCase.For more information, see OrdinalIgnoreCase. Klucz nie może być null.A key cannot be null.

Konstruktory

RouteValueDictionary()

Inicjuje nowe wystąpienie RouteValueDictionary klasy, która jest pusta.Initializes a new instance of the RouteValueDictionary class that is empty.

RouteValueDictionary(IDictionary<String,Object>)

Inicjuje nowe wystąpienie RouteValueDictionary klasy i dodaje elementy z określonej kolekcji.Initializes a new instance of the RouteValueDictionary class and adds elements from the specified collection.

RouteValueDictionary(Object)

Inicjuje nowe wystąpienie RouteValueDictionary klasy i dodaje wartości, które są oparte na właściwościach określonego obiektu.Initializes a new instance of the RouteValueDictionary class and adds values that are based on properties from the specified object.

Właściwości

Count

Pobiera liczbę par klucz/wartość, które znajdują się w kolekcji.Gets the number of key/value pairs that are in the collection.

Item[String]

Pobiera lub ustawia wartość, która jest skojarzona z określonym kluczem.Gets or sets the value that is associated with the specified key.

Keys

Pobiera kolekcję zawierającą klucze w słowniku.Gets a collection that contains the keys in the dictionary.

Values

Pobiera kolekcję zawierającą wartości w słowniku.Gets a collection that contains the values in the dictionary.

Metody

Add(String, Object)

Dodaje określoną wartość do słownika przy użyciu określonego klucza.Adds the specified value to the dictionary by using the specified key.

Clear()

Usuwa wszystkie klucze i wartości ze słownika.Removes all keys and values from the dictionary.

ContainsKey(String)

Określa, czy słownik zawiera określony klucz.Determines whether the dictionary contains the specified key.

ContainsValue(Object)

Określa, czy słownik zawiera konkretną wartość.Determines whether the dictionary contains a specific value.

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetEnumerator()

Zwraca moduł wyliczający, którego można użyć do iteracji w słowniku.Returns an enumerator that you can use to iterate through the dictionary.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
Remove(String)

Usuwa wartość, która ma określony klucz ze słownika.Removes the value that has the specified key from the dictionary.

ToString()

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
TryGetValue(String, Object)

Pobiera wartość wskazującą, czy wartość jest skojarzona z określonym kluczem.Gets a value that indicates whether a value is associated with the specified key.

Jawne implementacje interfejsu

ICollection<KeyValuePair<String,Object>>.Add(KeyValuePair<String,Object>)

Aby uzyskać opis tego elementu członkowskiego, Add(T)Zobacz.For a description of this member, see Add(T).

ICollection<KeyValuePair<String,Object>>.Contains(KeyValuePair<String,Object>)

Aby uzyskać opis tego elementu członkowskiego, Contains(T)Zobacz.For a description of this member, see Contains(T).

ICollection<KeyValuePair<String,Object>>.CopyTo(KeyValuePair<String,Object>[], Int32)

Aby uzyskać opis tego elementu członkowskiego, CopyTo(T[], Int32)Zobacz.For a description of this member, see CopyTo(T[], Int32).

ICollection<KeyValuePair<String,Object>>.IsReadOnly

Aby uzyskać opis tego elementu członkowskiego, IsReadOnlyZobacz.For a description of this member, see IsReadOnly.

ICollection<KeyValuePair<String,Object>>.Remove(KeyValuePair<String,Object>)

Aby uzyskać opis tego elementu członkowskiego, Remove(T)Zobacz.For a description of this member, see Remove(T).

IDictionary<String,Object>.Keys

Aby uzyskać opis tego elementu członkowskiego, KeysZobacz.For a description of this member, see Keys.

IDictionary<String,Object>.Values

Aby uzyskać opis tego elementu członkowskiego, ValuesZobacz.For a description of this member, see Values.

IEnumerable.GetEnumerator()

Aby uzyskać opis tego elementu członkowskiego, GetEnumerator()Zobacz.For a description of this member, see GetEnumerator().

IEnumerable<KeyValuePair<String,Object>>.GetEnumerator()

Aby uzyskać opis tego elementu członkowskiego, GetEnumerator()Zobacz.For a description of this member, see GetEnumerator().

Metody rozszerzania

CopyToDataTable<T>(IEnumerable<T>)

Zwraca DataTable, który zawiera kopie obiektów DataRow, przy użyciu obiektu wejściowego IEnumerable<T>, gdzie T parametru generycznego jest 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)

Kopiuje DataRow obiektów do określonego DataTable, używając obiektu wejściowego IEnumerable<T>, gdzie T parametru generycznego jest 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)

Kopiuje DataRow obiektów do określonego DataTable, używając obiektu wejściowego IEnumerable<T>, gdzie T parametru generycznego jest DataRow.Copies DataRow objects to the specified DataTable, given an input IEnumerable<T> object where the generic parameter T is DataRow.

Cast<TResult>(IEnumerable)

Rzutuje elementy IEnumerable określonego typu.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtruje elementy IEnumerable w oparciu o określony typ.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Włącza przetwarzanie równoległe zapytania.Enables parallelization of a query.

AsQueryable(IEnumerable)

Konwertuje IEnumerable na IQueryable.Converts an IEnumerable to an IQueryable.

Ancestors<T>(IEnumerable<T>)

Zwraca kolekcję elementów, które zawierają elementy nadrzędne każdego węzła w kolekcji źródłowej.Returns a collection of elements that contains the ancestors of every node in the source collection.

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

Zwraca przefiltrowany kolekcji elementów, które zawierają elementy nadrzędne każdego węzła w kolekcji źródłowej.Returns a filtered collection of elements that contains the ancestors of every node in the source collection. Kolekcja zawiera tylko elementy, które mają pasujące XName.Only elements that have a matching XName are included in the collection.

DescendantNodes<T>(IEnumerable<T>)

Zwraca kolekcję węzłów podrzędnych każdego dokumentu i elementu w kolekcji źródłowej.Returns a collection of the descendant nodes of every document and element in the source collection.

Descendants<T>(IEnumerable<T>)

Zwraca kolekcję elementów, które zawierają elementy podrzędne każdego elementu i dokumentu w kolekcji źródłowej.Returns a collection of elements that contains the descendant elements of every element and document in the source collection.

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

Zwraca przefiltrowany kolekcji elementów, które zawierają elementy podrzędne każdego elementu i dokumentu w kolekcji źródłowej.Returns a filtered collection of elements that contains the descendant elements of every element and document in the source collection. Kolekcja zawiera tylko elementy, które mają pasujące XName.Only elements that have a matching XName are included in the collection.

Elements<T>(IEnumerable<T>)

Zwraca kolekcję elementów podrzędnych każdego elementu i dokumentu w kolekcji źródłowej.Returns a collection of the child elements of every element and document in the source collection.

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

Zwraca filtrowaną kolekcję elementów podrzędnych każdego elementu i dokumentu w kolekcji źródłowej.Returns a filtered collection of the child elements of every element and document in the source collection. Kolekcja zawiera tylko elementy, które mają pasujące XName.Only elements that have a matching XName are included in the collection.

InDocumentOrder<T>(IEnumerable<T>)

Zwraca kolekcję węzłów, która zawiera wszystkie węzły w kolekcji źródłowej, posortowane w kolejności dokumentu.Returns a collection of nodes that contains all nodes in the source collection, sorted in document order.

Nodes<T>(IEnumerable<T>)

Zwraca kolekcję węzłów podrzędnych każdego dokumentu i elementu w kolekcji źródłowej.Returns a collection of the child nodes of every document and element in the source collection.

Remove<T>(IEnumerable<T>)

Usuwa każdy węzeł w kolekcji źródłowej z węzła nadrzędnego.Removes every node in the source collection from its parent node.

Dotyczy

Zobacz też