RouteParameter RouteParameter RouteParameter RouteParameter Class

Definition

Bindet den Wert eines URL-Segments an ein Parameterobjekt.Binds the value of a URL segment to a parameter object.

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
RouteParameterRouteParameterRouteParameterRouteParameter

Beispiele

In den Beispielen in diesem Abschnitt wird gezeigt, RouteParameter wie Sie-Objekte in Markup verwenden, um URL-Parameterwerte an eine Abfrage zu übergeben, die für ein Datenquellen-Steuerelement angegeben wird.The examples in this section show how to use RouteParameter objects in markup to pass URL parameter values to a query that is specified for a data source control.

Das folgende Beispiel zeigt den Code auf der Seite "Global. asax", der eine Route ProductRoutemit dem Namen definiert.The following example shows code in the Global.asax page that defines a route that is named ProductRoute. Die Route definiert einen URL-Parameter mit dem productnameNamen.The route defines a URL parameter that is named productname. Die Route definiert auch einen optionalen ""-Parameter mit dem Namen culture"", der zum Angeben der Sprache verwendet werden kann, in der die Produktbeschreibung angezeigt wird.The route also defines an optional catchall parameter that is named culture, which can be used to specify the language in which the product description is displayed. Die Product. aspx-Seite verarbeitet Anforderungen für diese Route.The Product.aspx page handles requests for this route.

Das folgende Beispiel zeigt die Product. aspx-Seite.The following example shows the Product.aspx page. Die Seite enthält ein SqlDataSource Steuerelement mit einer Abfrage, die zwei Parameter erfordert: eine für den Namen des Produkts und eine für die Sprache der Produktbeschreibung.The page contains a SqlDataSource control that has a query that requires two parameters, one for the name of the product and one for the language of the product description. RouteParameter-Objekte werden verwendet, um die Werte für die Abfrage Parameter bereitzustellen.RouteParameter objects are used to supply the values for the query parameters. Der Wert des Routen-URL- productname Parameters wird an den Abfrage @productnameParameter übergeben.The value of the route URL parameter productname is passed to the query parameter @productname. Der Wert des Routen-URL- culture Parameters wird an den Abfrage @cultureParameter übergeben.The value of the route URL parameter culture is passed to the query parameter @culture. Wenn eine Routen-URL den URL-Parameter culturenicht enthält, wird der Standardwert "en" verwendet.If a route URL does not include the URL parameter culture, a default value of "en" is used.

Das folgende Beispiel zeigt eine Seite mit dem Namen productlinks. aspx, die Links enthält, die mithilfe von Routen-URLs zur Seite Product. aspx verknüpft sind.The following example shows a page that is named ProductLinks.aspx, which contains hyperlinks that link to the Product.aspx page by using route URLs. Diese Hyperlinks verwenden RouteUrl Ausdrücke, um Routen-URLs zu erstellen.These hyperlinks use RouteUrl expressions to create route URLs. Der erste Link enthält culture keinen Routen Parameter.The first link does not include a culture route parameter. Daher wird der Standardwert von "en", der im-Objekt RouteParameter für @culture den Abfrage Parameter definiert ist, in der Abfrage verwendet.Therefore, the default value of "en" that is defined in the RouteParameter object for @culture query parameter will be used in the query. Der zweite Link enthält culture den Wert "fr", der bewirkt, dass die Beschreibung in Französisch angezeigt wird.The second link provides a culture value of "fr", which causes the description to be displayed in French. Weitere Informationen zum verwenden RouteUrl von Ausdrücken finden Sie unter Gewusst wie: Erstellen Sie URLs ausRouten.For more information about how to use RouteUrl expressions, see How to: Construct URLs from Routes.

Wenn Sie auf den ersten Link klicken, wird die Seite Product. aspx mit den folgenden Werten im GridView -Steuerelement angezeigt:When you click the first hyperlink, you see the Product.aspx page with the following values in the GridView control:

ProductIDProductID nameName BeschreibungDescription
994 LL Bottom Bracket Chromoly steel.

Wenn Sie auf den zweiten Link klicken, werden im GridView -Steuerelement die folgenden Werte angezeigt:When you click the second hyperlink, you see the following values in the GridView control:

ProductIDProductID nameName BeschreibungDescription
994 LL Bottom Bracket Acier chromé.

Fügen Sie zum Ausführen dieses Beispiels die beiden ASPX-Seiten und den Code in der Datei Global. asax einer ASP.NET-Website oder Webanwendung hinzu, die eine Verbindungs Zeichenfolge mit dem Namen AdventureWorksLTConnectionString für die AdventureWorksLT-Datenbank definiert.To run this example, add the two .aspx pages and the code in the Global.asax file to an ASP.NET Web site or Web application that defines a connection string named AdventureWorksLTConnectionString for the AdventureWorksLT database. Weitere Informationen zum Einrichten einer Verbindung mit der AdventureWorksLT-Datenbank finden Sie unter Gewusst wie: Richten Sie eine AdventureWorksLT-Beispieldatenbank für dieASP.net-Entwicklung ein.For information about how to set up a connection to the AdventureWorksLT database, see How to: Set Up an AdventureWorksLT Sample Database for ASP.NET Development.

Weitere Informationen zum Routing von ASP.net finden Sie unter ASP.NET Routing.For more information about ASP.NET routing, see ASP.NET Routing.

Hinweise

Wenn Sie das 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.If you implement ASP.NET routing in a Web site, you can use the RouteParameter object to bind the value of a segment of the requested URL to a database query or command. Sie können Objekte RouteParameter im Markup für Datenquellen Steuerelemente oder das QueryExtender -Steuerelement deklarieren.You can declare RouteParameter objects in markup for data source controls or the QueryExtender control.

Für dieses Thema steht ein Visual Studio-Website Projekt mit Quellcode zur Verfügung: Herunterladen.A Visual Studio Web site project with source code is available to accompany this topic: Download.

Konstruktoren

RouteParameter() RouteParameter() RouteParameter() RouteParameter()

Initialisiert eine neue Instanz der RouteParameter-Klasse.Initializes a new instance of the RouteParameter class.

RouteParameter(RouteParameter) RouteParameter(RouteParameter) RouteParameter(RouteParameter) RouteParameter(RouteParameter)

Initialisiert eine neue Instanz der RouteParameter-Klasse unter Verwendung der Werte der angegebenen Instanz.Initializes a new instance of the RouteParameter class by using the values of the specified instance.

RouteParameter(String, DbType, String) RouteParameter(String, DbType, String) RouteParameter(String, DbType, String) 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.Initializes a new instance of the RouteParameter class by using the specified name and database type for the parameter, and by using the specified key for the route data.

RouteParameter(String, String) RouteParameter(String, String) RouteParameter(String, String) 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.Initializes a new instance of the RouteParameter class by using the specified name for the parameter and the specified key for route data.

RouteParameter(String, TypeCode, String) RouteParameter(String, TypeCode, String) RouteParameter(String, TypeCode, String) 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.Initializes a new instance of the RouteParameter class by using the specified name and type for the parameter, and by using the specified key for the route data.

Eigenschaften

ConvertEmptyStringToNull ConvertEmptyStringToNull ConvertEmptyStringToNull 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.Gets or sets a value indicating whether the value that the Parameter object is bound to should be converted to null if it is Empty.

(Inherited from Parameter)
DbType DbType DbType DbType

Ruft den Datenbanktyp des Parameters ab oder legt diesen fest.Gets or sets the database type of the parameter.

(Inherited from Parameter)
DefaultValue DefaultValue DefaultValue 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.Specifies a default value for the parameter, should the value that the parameter is bound to be uninitialized when the Evaluate(HttpContext, Control) method is called.

(Inherited from Parameter)
Direction Direction Direction Direction

Gibt an, ob das Parameter-Objekt zum Binden eines Werts an ein Steuerelement oder das Steuerelement zum Ändern des Werts verwendet werden kann.Indicates whether the Parameter object is used to bind a value to a control, or the control can be used to change the value.

(Inherited from Parameter)
IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das Parameter-Objekt Änderungen des Ansichtszustands speichert.Gets a value indicating whether the Parameter object is saving changes to its view state.

(Inherited from Parameter)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das Parameter-Objekt Änderungen des Ansichtszustands speichert.Gets a value indicating whether the Parameter object is saving changes to its view state.

(Inherited from Parameter)
Name Name Name Name

Ruft den Namen des Parameters ab oder legt diesen fest.Gets or sets the name of the parameter.

(Inherited from Parameter)
RouteKey RouteKey RouteKey RouteKey

Ruft den Namen des Routensegments ab, von dem der Wert für den Routenparameter abgerufen wird, oder legt diesen fest.Gets or sets the name of the route segment from which to retrieve the value for the route parameter.

Size Size Size Size

Ruft die Größe des Parameters ab oder legt sie fest.Gets or sets the size of the parameter.

(Inherited from Parameter)
Type Type Type Type

Ruft den Typ des Parameters ab oder legt diesen fest.Gets or sets the type of the parameter.

(Inherited from Parameter)
ViewState ViewState ViewState 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.Gets a dictionary of state information that allows you to save and restore the view state of a Parameter object across multiple requests for the same page.

(Inherited from Parameter)

Methoden

Clone() Clone() Clone() Clone()

Gibt ein Duplikat der aktuellen RouteParameter-Instanz zurück.Returns a duplicate of the current RouteParameter instance.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Evaluate(HttpContext, Control) Evaluate(HttpContext, Control) Evaluate(HttpContext, Control) Evaluate(HttpContext, Control)

Wertet die Anforderungs-URL aus und gibt den Wert des Parameters zurück.Evaluates the request URL and returns the value of the parameter.

GetDatabaseType() GetDatabaseType() GetDatabaseType() GetDatabaseType()

Ruft den DbType-Wert ab, der dem CLR-Typ der aktuellen Parameter-Instanz entspricht.Gets the DbType value that is equivalent to the CLR type of the current Parameter instance.

(Inherited from Parameter)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her.Restores the data source view's previously saved view state.

(Inherited from Parameter)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnParameterChanged() OnParameterChanged() OnParameterChanged() OnParameterChanged()

Ruft die OnParametersChanged(EventArgs)-Methode der ParameterCollection-Auflistung auf, die das Parameter-Objekt enthält.Calls the OnParametersChanged(EventArgs) method of the ParameterCollection collection that contains the Parameter object.

(Inherited from Parameter)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

Speichert die Änderungen am Ansichtszustand des Parameter-Objekts seit dem Zeitpunkt, zu dem die Seite zurück an den Server gesendet wurde.Saves the changes to the Parameter object's view state since the time the page was posted back to the server.

(Inherited from Parameter)
SetDirty() SetDirty() SetDirty() SetDirty()

Markiert das Parameter-Objekt, damit sein Zustand im Ansichtszustand aufgezeichnet wird.Marks the Parameter object so its state will be recorded in view state.

(Inherited from Parameter)
ToString() ToString() ToString() ToString()

Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung.Converts the value of this instance to its equivalent string representation.

(Inherited from Parameter)
TrackViewState() TrackViewState() TrackViewState() 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.Causes the Parameter object to track changes to its view state so they can be stored in the control's ViewState object and persisted across requests for the same page.

(Inherited from Parameter)

Explizite Schnittstellenimplementierungen

ICloneable.Clone() ICloneable.Clone() ICloneable.Clone() ICloneable.Clone()

Gibt ein Duplikat der aktuellen Parameter-Instanz zurück.Returns a duplicate of the current Parameter instance.

(Inherited from Parameter)
IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her.Restores the data source view's previously saved view state.

(Inherited from Parameter)
IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

Speichert die Änderungen am Ansichtszustand des Parameter-Objekts seit dem Zeitpunkt, zu dem die Seite zurück an den Server gesendet wurde.Saves the changes to the Parameter object's view state since the time the page was posted back to the server.

(Inherited from Parameter)
IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() 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.Causes the Parameter object to track changes to its view state so they can be stored in the control's ViewState object and persisted across requests for the same page.

(Inherited from Parameter)

Gilt für:

Siehe auch