RouteParameter Klasse

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bindet den Wert eines URL-Segments an ein Parameterobjekt.

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

Vererbung: Object

Parameter
RouteParameter

Beispiele

Die Beispiele in diesem Abschnitt zeigen, wie Objekte im Markup verwendet RouteParameter werden, um URL-Parameterwerte an eine Abfrage zu übergeben, die für ein Datenquellensteuerelement angegeben ist.

Das folgende Beispiel zeigt Code auf der Seite Global.asax, der eine Route mit dem Namen ProductRoutedefiniert. Die Route definiert einen URL-Parameter namens productname. Die Route definiert auch einen optionalen Catchall-Parameter namens culture, der verwendet werden kann, um die Sprache anzugeben, in der die Produktbeschreibung angezeigt wird. Die Seite "Product.aspx" verarbeitet Anforderungen für diese Route.

Das folgende Beispiel zeigt die Seite Product.aspx. Die Seite enthält ein SqlDataSource Steuerelement mit einer Abfrage, die zwei Parameter erfordert: einen für den Namen des Produkts und einen für die Sprache der Produktbeschreibung. RouteParameter -Objekte werden verwendet, um die Werte für die Abfrageparameter anzugeben. Der Wert des Routen-URL-Parameters productname wird an den Abfrageparameter @productnameübergeben. Der Wert des Routen-URL-Parameters culture wird an den Abfrageparameter @cultureübergeben. Wenn eine Routen-URL den URL-Parameter culturenicht enthält, wird der Standardwert "en" verwendet.

Das folgende Beispiel zeigt eine Seite mit dem Namen ProductLinks.aspx, die Links enthält, die mithilfe von Routen-URLs auf die Seite "Product.aspx" verweisen. Diese Links verwenden RouteUrl Ausdrücke, um Routen-URLs zu erstellen. Der erste Link enthält culture keinen Routenparameter. Daher wird der Standardwert "en", der im Objekt für @culture abfrageparameter RouteParameter definiert ist, in der Abfrage verwendet. Der zweite Link enthält den culture Wert "fr", wodurch die Beschreibung auf Französisch angezeigt wird. Weitere Informationen zur Verwendung von RouteUrl Ausdrücken finden Sie unter Vorgehensweise: Erstellen von URLs aus Routen.

Wenn Sie auf den ersten Link klicken, wird die Seite Product.aspx mit den folgenden Werten im GridView Steuerelement angezeigt:

ProductID	Name	BESCHREIBUNG
`994`	`LL Bottom Bracket`	`Chromoly steel.`

Wenn Sie auf den zweiten Link klicken, werden die folgenden Werte im GridView Steuerelement angezeigt:

ProductID	Name	BESCHREIBUNG
`994`	`LL Bottom Bracket`	`Acier chromé.`

Um dieses Beispiel auszuführen, fügen Sie die beiden ASPX-Seiten und den Code in der Datei Global.asax einer ASP.NET-Website oder Webanwendung hinzu, die eine Verbindungszeichenfolge namens AdventureWorksLTConnectionString für die AdventureWorksLT-Datenbank definiert. Informationen zum Einrichten einer Verbindung mit der AdventureWorksLT-Datenbank finden Sie unter Vorgehensweise: Einrichten einer AdventureWorksLT-Beispieldatenbank für ASP.NET-Entwicklung.

Weitere Informationen zum ASP.NET Routing finden Sie unter ASP.NET Routing.

Hinweise

Wenn Sie ASP.NET Routing in einer Website implementieren, können Sie das RouteParameter -Objekt verwenden, um den Wert eines Segments der angeforderten URL an eine Datenbankabfrage oder einen Befehl zu binden. Sie können Objekte im Markup für Datenquellensteuerelemente oder das QueryExtender -Steuerelement deklarierenRouteParameter.

Für dieses Thema steht ein Visual Studio-Websiteprojekt mit Quellcode zur Verfügung: Download.

Konstruktoren

RouteParameter()	Initialisiert eine neue Instanz der RouteParameter-Klasse.
RouteParameter(RouteParameter)	Initialisiert eine neue Instanz der RouteParameter-Klasse unter Verwendung der Werte der angegebenen Instanz.
RouteParameter(String, DbType, String)	Initialisiert eine neue Instanz der RouteParameter-Klasse unter Verwendung des angegebenen Namens und Datenbanktyps für den Parameter sowie des angegebenen Schlüssels für die Routendaten.
RouteParameter(String, String)	Initialisiert eine neue Instanz der RouteParameter-Klasse unter Verwendung des angegebenen Namens für den Parameter sowie des angegebenen Schlüssels für die Routendaten.
RouteParameter(String, TypeCode, String)	Initialisiert eine neue Instanz der RouteParameter-Klasse unter Verwendung des angegebenen Namens und Typs für den Parameter sowie des angegebenen Schlüssels für die Routendaten.

Eigenschaften

ConvertEmptyStringToNull	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob der Wert, an den das Parameter-Objekt gebunden ist, nach `null` konvertiert werden soll, wenn er Empty ist. (Geerbt von Parameter)
DbType	Ruft den Datenbanktyp des Parameters ab oder legt diesen fest. (Geerbt von Parameter)
DefaultValue	Gibt einen Standardwert für den Parameter an, wenn der Wert, an den der Parameter gebunden ist, beim Aufrufen der Evaluate(HttpContext, Control)-Methode nicht initialisiert ist. (Geerbt von Parameter)
Direction	Gibt an, ob das Parameter-Objekt zum Binden eines Werts an ein Steuerelement oder das Steuerelement zum Ändern des Werts verwendet werden kann. (Geerbt von Parameter)
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das Parameter-Objekt Änderungen des Ansichtszustands speichert. (Geerbt von Parameter)
Name	Ruft den Namen des Parameters ab oder legt ihn fest. (Geerbt von Parameter)
RouteKey	Ruft den Namen des Routensegments ab, von dem der Wert für den Routenparameter abgerufen wird, oder legt diesen fest.
Size	Ruft die Größe des Parameters ab oder legt sie fest. (Geerbt von Parameter)
Type	Ruft den Typ des Parameters ab oder legt ihn fest. (Geerbt von Parameter)
ViewState	Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Parameter-Objekts über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können. (Geerbt von Parameter)

Methoden

Clone()	Gibt ein Duplikat der aktuellen RouteParameter-Instanz zurück.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
Evaluate(HttpContext, Control)	Wertet die Anforderungs-URL aus und gibt den Wert des Parameters zurück.
GetDatabaseType()	Ruft den DbType-Wert ab, der dem CLR-Typ der aktuellen Parameter-Instanz entspricht. (Geerbt von Parameter)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
LoadViewState(Object)	Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her. (Geerbt von Parameter)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnParameterChanged()	Ruft die OnParametersChanged(EventArgs)-Methode der ParameterCollection-Auflistung auf, die das Parameter-Objekt enthält. (Geerbt von Parameter)
SaveViewState()	Speichert die Änderungen am Ansichtszustand des Parameter-Objekts seit dem Zeitpunkt, zu dem die Seite zurück an den Server gesendet wurde. (Geerbt von Parameter)
SetDirty()	Markiert das Parameter-Objekt, damit sein Zustand im Ansichtszustand aufgezeichnet wird. (Geerbt von Parameter)
ToString()	Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung. (Geerbt von Parameter)
TrackViewState()	Bewirkt, dass das Parameter-Objekt Änderungen an ihrem Ansichtszustand nachverfolgt, damit sie im ViewState-Objekt des Steuerelements gespeichert und über Anforderungen der gleichen Seite hinweg beibehalten werden. (Geerbt von Parameter)

Explizite Schnittstellenimplementierungen

ICloneable.Clone()	Gibt ein Duplikat der aktuellen Parameter-Instanz zurück. (Geerbt von Parameter)
IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das Parameter-Objekt Änderungen des Ansichtszustands speichert. (Geerbt von Parameter)
IStateManager.LoadViewState(Object)	Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her. (Geerbt von Parameter)
IStateManager.SaveViewState()	Speichert die Änderungen am Ansichtszustand des Parameter-Objekts seit dem Zeitpunkt, zu dem die Seite zurück an den Server gesendet wurde. (Geerbt von Parameter)
IStateManager.TrackViewState()	Bewirkt, dass das Parameter-Objekt Änderungen an ihrem Ansichtszustand nachverfolgt, damit sie im ViewState-Objekt des Steuerelements gespeichert und über Anforderungen der gleichen Seite hinweg beibehalten werden. (Geerbt von Parameter)

Gilt für: