RouteParameter RouteParameter RouteParameter RouteParameter Class

Definizione

Associa il valore di un segmento di URL a un oggetto parametro.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
Ereditarietà
RouteParameterRouteParameterRouteParameterRouteParameter

Esempi

Negli esempi di questa sezione viene illustrato come utilizzare RouteParameter gli oggetti nel markup per passare i valori dei parametri URL a una query specificata per un controllo origine dati.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.

Nell'esempio seguente viene illustrato il codice nella pagina Global. asax che definisce una route denominata ProductRoute.The following example shows code in the Global.asax page that defines a route that is named ProductRoute. La route definisce un parametro URL denominato productname.The route defines a URL parameter that is named productname. La route definisce anche un parametro facoltativo catchall denominato culture, che può essere usato per specificare la lingua in cui viene visualizzata la descrizione del prodotto.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. La pagina Product. aspx gestisce le richieste per questa route.The Product.aspx page handles requests for this route.

Nell'esempio seguente viene illustrata la pagina Product. aspx.The following example shows the Product.aspx page. La pagina contiene un SqlDataSource controllo che dispone di una query che richiede due parametri, uno per il nome del prodotto e uno per la lingua della descrizione del prodotto.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. RouteParametergli oggetti vengono utilizzati per fornire i valori per i parametri di query.RouteParameter objects are used to supply the values for the query parameters. Il valore del parametro productname route URL viene passato al parametro @productnamedi query.The value of the route URL parameter productname is passed to the query parameter @productname. Il valore del parametro culture route URL viene passato al parametro @culturedi query.The value of the route URL parameter culture is passed to the query parameter @culture. Se un URL di route non include il parametro cultureURL, viene usato il valore predefinito "en".If a route URL does not include the URL parameter culture, a default value of "en" is used.

Nell'esempio seguente viene illustrata una pagina denominata ProductLinks. aspx, che contiene collegamenti ipertestuali che si collegano alla pagina Product. aspx tramite URL di route.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. Questi collegamenti ipertestuali usano RouteUrl espressioni per creare URL di route.These hyperlinks use RouteUrl expressions to create route URLs. Il primo collegamento non include un parametro culture di route.The first link does not include a culture route parameter. Pertanto, nella query verrà utilizzato il valore predefinito "en" definito nell' RouteParameter oggetto per @culture il parametro di query.Therefore, the default value of "en" that is defined in the RouteParameter object for @culture query parameter will be used in the query. Il secondo collegamento fornisce un culture valore di "fr", che fa sì che la descrizione venga visualizzata in francese.The second link provides a culture value of "fr", which causes the description to be displayed in French. Per ulteriori informazioni sull'utilizzo RouteUrl delle espressioni, vedere procedura: Costruire URL dalle route.For more information about how to use RouteUrl expressions, see How to: Construct URLs from Routes.

Quando si fa clic sul primo collegamento ipertestuale, viene visualizzata la pagina Product. aspx con i valori GridView seguenti nel controllo:When you click the first hyperlink, you see the Product.aspx page with the following values in the GridView control:

ProductIDProductID nomeName DescriptionDescription
994 LL Bottom Bracket Chromoly steel.

Quando si fa clic sul secondo collegamento ipertestuale, nel GridView controllo vengono visualizzati i valori seguenti:When you click the second hyperlink, you see the following values in the GridView control:

ProductIDProductID nomeName DescriptionDescription
994 LL Bottom Bracket Acier chromé.

Per eseguire questo esempio, aggiungere le due pagine aspx e il codice nel file Global. asax a un sito Web o a un'applicazione Web ASP.NET che definisce una stringa di connessione AdventureWorksLTConnectionString denominata per il database AdventureWorksLT.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. Per informazioni sulla configurazione di una connessione al database AdventureWorksLT, vedere procedura: Configurare un database di esempio AdventureWorksLT per lo sviluppoASP.NET.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.

Per altre informazioni sul routing ASP.NET, vedere routing ASP.NET.For more information about ASP.NET routing, see ASP.NET Routing.

Commenti

Se si implementa il routing ASP.NET in un sito Web, è possibile utilizzare RouteParameter l'oggetto per associare il valore di un segmento dell'URL richiesto a una query o a un comando del database.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. È possibile dichiarare RouteParameter gli oggetti nel markup per i controlli origine dati QueryExtender o il controllo.You can declare RouteParameter objects in markup for data source controls or the QueryExtender control.

Per accompagnare questo argomento, è disponibile un progetto di sito Web di Visual Studio con codice sorgente: Scaricare.A Visual Studio Web site project with source code is available to accompany this topic: Download.

Costruttori

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

Inizializza una nuova istanza della classe RouteParameter.Initializes a new instance of the RouteParameter class.

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

Inizializza una nuova istanza della classe RouteParameter utilizzando i valori dell'istanza specificata.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)

Inizializza una nuova istanza della classe RouteParameter utilizzando il nome e il tipo di database specificati per il parametro, nonché la chiave specificata per i dati della route.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)

Inizializza una nuova istanza della classe RouteParameter utilizzando il nome specificato per il parametro e la chiave specificata per i dati della route.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)

Inizializza una nuova istanza della classe RouteParameter utilizzando il nome e il tipo specificati per il parametro, nonché la chiave specificata per i dati della route.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.

Proprietà

ConvertEmptyStringToNull ConvertEmptyStringToNull ConvertEmptyStringToNull ConvertEmptyStringToNull

Ottiene o imposta un valore indicante se il valore a cui è associato l'oggetto Parameter deve essere convertito in null se è Empty.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

Ottiene o imposta il tipo di database del parametro.Gets or sets the database type of the parameter.

(Inherited from Parameter)
DefaultValue DefaultValue DefaultValue DefaultValue

Specifica un valore predefinito per il parametro, se il valore associato al parametro non deve essere inizializzato quando viene chiamato il metodo Evaluate(HttpContext, Control).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

Indica se l'oggetto Parameter viene utilizzato per associare un valore a un controllo oppure il controllo può essere utilizzato per la modifica del valore.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

Ottiene un valore che indica se l'oggetto Parameter sta salvando le modifiche apportate al relativo stato di visualizzazione.Gets a value indicating whether the Parameter object is saving changes to its view state.

(Inherited from Parameter)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Ottiene un valore che indica se l'oggetto Parameter sta salvando le modifiche apportate al relativo stato di visualizzazione.Gets a value indicating whether the Parameter object is saving changes to its view state.

(Inherited from Parameter)
Name Name Name Name

Ottiene o imposta il nome del parametro.Gets or sets the name of the parameter.

(Inherited from Parameter)
RouteKey RouteKey RouteKey RouteKey

Ottiene o imposta il nome del segmento di route da cui recuperare il valore per il parametro della route.Gets or sets the name of the route segment from which to retrieve the value for the route parameter.

Size Size Size Size

Ottiene o imposta le dimensioni del parametro.Gets or sets the size of the parameter.

(Inherited from Parameter)
Type Type Type Type

Ottiene o imposta il tipo di parametro.Gets or sets the type of the parameter.

(Inherited from Parameter)
ViewState ViewState ViewState ViewState

Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un oggetto Parameter tra più richieste per la stessa pagina.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)

Metodi

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

Restituisce un duplicato dell'istanza RouteParameter corrente.Returns a duplicate of the current RouteParameter instance.

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

Determina se l'oggetto specificato è uguale all'oggetto corrente.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)

Valuta l'URL della richiesta e restituisce il valore del parametro.Evaluates the request URL and returns the value of the parameter.

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

Ottiene il valore DbType che è equivalente al tipo CLR dell'istanza corrente di Parameter.Gets the DbType value that is equivalent to the CLR type of the current Parameter instance.

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

Funge da funzione hash predefinita.Serves as the default hash function.

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

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

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

Ripristina lo stato di visualizzazione precedentemente salvato della visualizzazione origine dati.Restores the data source view's previously saved view state.

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

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

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

Chiame il metodo OnParametersChanged(EventArgs) dell'insieme ParameterCollection che contiene l'oggetto Parameter.Calls the OnParametersChanged(EventArgs) method of the ParameterCollection collection that contains the Parameter object.

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

Salva le modifiche apportate allo stato di visualizzazione dell'oggetto Parameter dal momento in cui è stato eseguito il postback della pagina al server.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()

Contrassegna l'oggetto Parameter in modo che il relativo stato venga registrato in stato di visualizzazione.Marks the Parameter object so its state will be recorded in view state.

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

Converte il valore dell'istanza corrente nell'equivalente rappresentazione di stringa.Converts the value of this instance to its equivalent string representation.

(Inherited from Parameter)
TrackViewState() TrackViewState() TrackViewState() TrackViewState()

Mediante questo metodo l'oggetto Parameter tiene traccia delle modifiche apportate al relativo stato di visualizzazione in modo che vengono memorizzate nell'oggetto ViewState del controllo e mantenute nelle richieste della stessa pagina.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)

Implementazioni dell'interfaccia esplicita

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

Restituisce un duplicato dell'istanza Parameter corrente.Returns a duplicate of the current Parameter instance.

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

Ripristina lo stato di visualizzazione precedentemente salvato della visualizzazione origine dati.Restores the data source view's previously saved view state.

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

Salva le modifiche apportate allo stato di visualizzazione dell'oggetto Parameter dal momento in cui è stato eseguito il postback della pagina al server.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()

Mediante questo metodo l'oggetto Parameter tiene traccia delle modifiche apportate al relativo stato di visualizzazione in modo che vengono memorizzate nell'oggetto ViewState del controllo e mantenute nelle richieste della stessa pagina.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)

Si applica a

Vedi anche