RouteParameter Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Associa il valore di un segmento di URL a un oggetto parametro.

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à: Object

Parameter
RouteParameter

Esempio

Gli esempi di questa sezione illustrano come usare RouteParameter gli oggetti nel markup per passare i valori dei parametri URL a una query specificata per un controllo origine dati.

Nell'esempio seguente viene illustrato il codice nella pagina Global.asax che definisce una route denominata ProductRoute. La route definisce un parametro URL denominato productname. La route definisce anche un parametro catchall facoltativo denominato culture, che può essere usato per specificare la lingua in cui viene visualizzata la descrizione del prodotto. La pagina Product.aspx gestisce le richieste per questa route.

Nell'esempio seguente viene illustrata la pagina Product.aspx. La pagina contiene un SqlDataSource controllo con una query che richiede due parametri, uno per il nome del prodotto e uno per la lingua della descrizione del prodotto. RouteParameter gli oggetti vengono usati per specificare i valori per i parametri di query. Il valore del parametro URL di route viene passato al parametro productname@productnamedi query . Il valore del parametro URL di route viene passato al parametro culture@culturedi query . Se un URL di route non include il parametro cultureURL , viene usato un valore predefinito "en".

Nell'esempio seguente viene illustrata una pagina denominata ProductLinks.aspx che contiene collegamenti ipertestuali alla pagina Product.aspx usando URL di route. Questi collegamenti ipertestuali usano RouteUrl espressioni per creare URL di route. Il primo collegamento non include un culture parametro di route. Pertanto, il valore predefinito "en" definito nell'oggetto RouteParameter per @culture il parametro di query verrà usato nella query. Il secondo collegamento fornisce un culture valore "fr", che causa la visualizzazione della descrizione in francese. Per altre informazioni su come usare RouteUrl espressioni, vedere Procedura: Costrutti URL da Route.

Quando si fa clic sul primo collegamento ipertestuale, viene visualizzata la pagina Product.aspx con i valori seguenti nel GridView controllo:

ProductID	Nome	Descrizione
`994`	`LL Bottom Bracket`	`Chromoly steel.`

Quando si fa clic sul secondo collegamento ipertestuale, nel controllo sono visualizzati i valori GridView seguenti:

ProductID	Nome	Descrizione
`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 ASP.NET o applicazione Web che definisce una stringa di connessione denominata AdventureWorksLTConnectionString per il database AdventureWorksLT. Per informazioni su come configurare una connessione al database AdventureWorksLT, vedere Procedura: Configurare un database di esempio AdventureWorksLT per lo sviluppo di ASP.NET.

Per altre informazioni sul routing ASP.NET, vedere routing ASP.NET.

Commenti

Se si implementa ASP.NET routing in un sito Web, è possibile usare l'oggetto per associare il valore di un segmento dell'URL RouteParameter richiesto a una query o a un comando del database. È possibile dichiarare RouteParameter gli oggetti nel markup per i controlli origine dati o il QueryExtender controllo.

Per accompagnare questo argomento, è disponibile un progetto di sito Web di Visual Studio con codice sorgente.

Costruttori

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

Proprietà

ConvertEmptyStringToNull	Ottiene o imposta un valore indicante se il valore a cui è associato l'oggetto Parameter deve essere convertito in `null` se è Empty. (Ereditato da Parameter)
DbType	Ottiene o imposta il tipo di database del parametro. (Ereditato da Parameter)
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). (Ereditato da Parameter)
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. (Ereditato da Parameter)
IsTrackingViewState	Ottiene un valore che indica se l'oggetto Parameter sta salvando le modifiche apportate al relativo stato di visualizzazione. (Ereditato da Parameter)
Name	Ottiene o imposta il nome del parametro. (Ereditato da Parameter)
RouteKey	Ottiene o imposta il nome del segmento di route da cui recuperare il valore per il parametro della route.
Size	Ottiene o imposta le dimensioni del parametro. (Ereditato da Parameter)
Type	Ottiene o imposta il tipo del parametro. (Ereditato da Parameter)
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. (Ereditato da Parameter)

Metodi

Clone()	Restituisce un duplicato dell'istanza RouteParameter corrente.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Evaluate(HttpContext, Control)	Valuta l'URL della richiesta e restituisce il valore del parametro.
GetDatabaseType()	Ottiene il valore DbType che è equivalente al tipo CLR dell'istanza corrente di Parameter. (Ereditato da Parameter)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
LoadViewState(Object)	Ripristina lo stato di visualizzazione precedentemente salvato della visualizzazione origine dati. (Ereditato da Parameter)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnParameterChanged()	Chiame il metodo OnParametersChanged(EventArgs) dell'insieme ParameterCollection che contiene l'oggetto Parameter. (Ereditato da Parameter)
SaveViewState()	Salva le modifiche apportate allo stato di visualizzazione dell'oggetto Parameter dal momento in cui è stato eseguito il postback della pagina al server. (Ereditato da Parameter)
SetDirty()	Contrassegna l'oggetto Parameter in modo che il relativo stato venga registrato in stato di visualizzazione. (Ereditato da Parameter)
ToString()	Converte il valore dell'istanza corrente nell'equivalente rappresentazione di stringa. (Ereditato da Parameter)
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. (Ereditato da Parameter)

Implementazioni dell'interfaccia esplicita

ICloneable.Clone()	Restituisce un duplicato dell'istanza Parameter corrente. (Ereditato da Parameter)
IStateManager.IsTrackingViewState	Ottiene un valore che indica se l'oggetto Parameter sta salvando le modifiche apportate al relativo stato di visualizzazione. (Ereditato da Parameter)
IStateManager.LoadViewState(Object)	Ripristina lo stato di visualizzazione precedentemente salvato della visualizzazione origine dati. (Ereditato da Parameter)
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. (Ereditato da Parameter)
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. (Ereditato da Parameter)

Si applica a