RouteValueDictionary Klasse

Definition

Stellt eine Auflistung von Schlüssel-Wert-Paaren ohne Beachtung von Groß- und Kleinschreibung dar, die Sie an unterschiedlichen Stellen im Routingframework verwenden, z. B. beim Definieren der Standardwerte für eine Route oder beim Generieren einer URL auf Grundlage einer Route.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))
Vererbung
RouteValueDictionary
Implementiert

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein Route -Objekt erstellt wird und wie Constraintsdie DataTokensEigenschaften, Defaults und festgelegt werden.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

Hinweise

Mit RouteValueDictionary der-Klasse können Sie mit Auflistungen von Schlüssel-Wert-Paaren arbeiten, die erforderlich sind, um das ASP.NET-Routing zu verwenden.The RouteValueDictionary class enables you to work with collections of key/value pairs that are required in order to use ASP.NET routing. Sie verwenden das RouteValueDictionary -Objekt, um Werte für Constraintsdie DataTokensEigenschaften, Defaults und zu definieren.You use the RouteValueDictionary object to define values for the Constraints, DataTokens, and Defaults properties. Sie können auch ein RouteValueDictionary -Objekt verwenden, wenn Sie eine URL generieren GetVirtualPath , indem Sie die RouteValueDictionary -Methode aufrufen und ein-Objekt als Parameter übergeben.You also use a RouteValueDictionary object when you generate a URL by calling the GetVirtualPath method and passing a RouteValueDictionary object as a parameter.

Jeder Schlüssel in einem RouteValueDictionary -Objekt muss eindeutig sein.Every key in a RouteValueDictionary object must be unique. Die RouteValueDictionary Klasse verwendet einen Ordinalvergleich ohne Beachtung der Groß-/KleinschreibungThe RouteValueDictionary class uses case-insensitive ordinal comparison. Weitere Informationen finden Sie unter OrdinalIgnoreCase.For more information, see OrdinalIgnoreCase. Ein Schlüssel kann nicht nullsein.A key cannot be null.

Konstruktoren

RouteValueDictionary()

Initialisiert eine neue, leere Instanz der RouteValueDictionary-Klasse.Initializes a new instance of the RouteValueDictionary class that is empty.

RouteValueDictionary(IDictionary<String,Object>)

Initialisiert eine neue Instanz der RouteValueDictionary-Klasse und fügt Elemente aus der angegebenen Auflistung hinzu.Initializes a new instance of the RouteValueDictionary class and adds elements from the specified collection.

RouteValueDictionary(Object)

Initialisiert eine neue Instanz der RouteValueDictionary-Klasse und fügt Werte auf Grundlage von Eigenschaften des angegebenen Objekts hinzu.Initializes a new instance of the RouteValueDictionary class and adds values that are based on properties from the specified object.

Eigenschaften

Count

Ruft die Anzahl der Schlüssel-Wert-Paare in der Auflistung ab.Gets the number of key/value pairs that are in the collection.

Item[String]

Ruft den Wert ab, der dem angegebenen Schlüssel zugeordnet ist, oder legt diesen fest.Gets or sets the value that is associated with the specified key.

Keys

Ruft eine Auflistung ab, die die Schlüssel im Wörterbuch enthält.Gets a collection that contains the keys in the dictionary.

Values

Ruft eine Auflistung ab, die die Werte im Wörterbuch enthält.Gets a collection that contains the values in the dictionary.

Methoden

Add(String, Object)

Fügt dem Wörterbuch den angegebenen Wert mithilfe des angegebenen Schlüssels hinzu.Adds the specified value to the dictionary by using the specified key.

Clear()

Entfernt sämtliche Schlüssel und Werte aus dem Wörterbuch.Removes all keys and values from the dictionary.

ContainsKey(String)

Ermittelt, ob das Wörterbuch den angegebenen Schlüssel enthält.Determines whether the dictionary contains the specified key.

ContainsValue(Object)

Ermittelt, ob das Wörterbuch einen bestimmten Wert enthält.Determines whether the dictionary contains a specific value.

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetEnumerator()

Gibt einen Enumerator zurück, mit dem das Wörterbuch durchlaufen werden kann.Returns an enumerator that you can use to iterate through the dictionary.

GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
Remove(String)

Entfernt den Wert mit dem angegebenen Schlüssel aus dem Wörterbuch.Removes the value that has the specified key from the dictionary.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)
TryGetValue(String, Object)

Ruft einen Wert ab, der angibt, ob ein Wert dem angegebenen Schlüssel zugeordnet ist.Gets a value that indicates whether a value is associated with the specified key.

Explizite Schnittstellenimplementierungen

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

Eine Beschreibung dieses Elements finden Sie unter Add(T).For a description of this member, see Add(T).

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

Eine Beschreibung dieses Elements finden Sie unter Contains(T).For a description of this member, see Contains(T).

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

Eine Beschreibung dieses Members finden Sie unter CopyTo(T[], Int32).For a description of this member, see CopyTo(T[], Int32).

ICollection<KeyValuePair<String,Object>>.IsReadOnly

Eine Beschreibung dieses Elements finden Sie unter IsReadOnly.For a description of this member, see IsReadOnly.

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

Eine Beschreibung dieses Members finden Sie unter Remove(T).For a description of this member, see Remove(T).

IDictionary<String,Object>.Keys

Eine Beschreibung dieses Elements finden Sie unter Keys.For a description of this member, see Keys.

IDictionary<String,Object>.Values

Eine Beschreibung dieses Elements finden Sie unter Values.For a description of this member, see Values.

IEnumerable.GetEnumerator()

Eine Beschreibung dieses Elements finden Sie unter GetEnumerator().For a description of this member, see GetEnumerator().

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

Eine Beschreibung dieses Elements finden Sie unter GetEnumerator().For a description of this member, see GetEnumerator().

Erweiterungsmethoden

CopyToDataTable<T>(IEnumerable<T>)

Gibt eine DataTable zurück, die Kopien der DataRow-Objekte enthält, wenn ein IEnumerable<T>-Eingabeobjekt vorhanden ist, bei dem der generische Parameter T den Wert DataRow hat.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)

Kopiert DataRow-Objekte in die angegebene DataTable, bei einem IEnumerable<T>-Eingabeobjekt, bei dem der generische Parameter T den Wert DataRow aufweist.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)

Kopiert DataRow-Objekte in die angegebene DataTable, bei einem IEnumerable<T>-Eingabeobjekt, bei dem der generische Parameter T den Wert DataRow aufweist.Copies DataRow objects to the specified DataTable, given an input IEnumerable<T> object where the generic parameter T is DataRow.

Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ umCasts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen TypsFilters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.Enables parallelization of a query.

AsQueryable(IEnumerable)

Konvertiert einen IEnumerable in einen IQueryable.Converts an IEnumerable to an IQueryable.

Ancestors<T>(IEnumerable<T>)

Gibt eine Auflistung von Elementen zurück, die die übergeordneten Elemente der einzelnen Knoten in der Quellauflistung enthält.Returns a collection of elements that contains the ancestors of every node in the source collection.

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

Gibt eine gefilterte Auflistung von Elementen zurück, die die übergeordneten Elemente der einzelnen Knoten in der Quellauflistung enthält.Returns a filtered collection of elements that contains the ancestors of every node in the source collection. Nur Elemente, die über einen übereinstimmenden XName verfügen, sind in der Auflistung enthalten.Only elements that have a matching XName are included in the collection.

DescendantNodes<T>(IEnumerable<T>)

Gibt eine Auflistung der Nachfolgerknoten jedes Dokuments und Elements in der Quellauflistung zurück.Returns a collection of the descendant nodes of every document and element in the source collection.

Descendants<T>(IEnumerable<T>)

Gibt eine Auflistung von Elementen zurück, die die Nachfolgerelemente jedes Elements und Dokuments in der Quellauflistung enthält.Returns a collection of elements that contains the descendant elements of every element and document in the source collection.

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

Gibt eine gefilterte Auflistung von Elementen zurück, die die Nachfolgerelemente jedes Elements und Dokuments in der Quellauflistung enthält.Returns a filtered collection of elements that contains the descendant elements of every element and document in the source collection. Nur Elemente, die über einen übereinstimmenden XName verfügen, sind in der Auflistung enthalten.Only elements that have a matching XName are included in the collection.

Elements<T>(IEnumerable<T>)

Gibt eine Auflistung der untergeordneten Elemente jedes Elements und Dokuments in der Quellauflistung zurück.Returns a collection of the child elements of every element and document in the source collection.

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

Gibt eine gefilterte Auflistung der untergeordneten Elemente jedes Elements und Dokuments in der Quellauflistung zurück.Returns a filtered collection of the child elements of every element and document in the source collection. Nur Elemente, die über einen übereinstimmenden XName verfügen, sind in der Auflistung enthalten.Only elements that have a matching XName are included in the collection.

InDocumentOrder<T>(IEnumerable<T>)

Gibt eine in Dokumentreihenfolge sortierte Auflistung von Knoten zurück, die alle Knoten in der Quellauflistung enthält.Returns a collection of nodes that contains all nodes in the source collection, sorted in document order.

Nodes<T>(IEnumerable<T>)

Gibt eine Auflistung der untergeordneten Knoten jedes Dokuments und Elements in der Quellauflistung zurück.Returns a collection of the child nodes of every document and element in the source collection.

Remove<T>(IEnumerable<T>)

Entfernt jeden Knoten in der Quellauflistung aus seinem übergeordneten Knoten.Removes every node in the source collection from its parent node.

Gilt für:

Siehe auch