RouteParameter Třída

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vytvoří vazbu hodnoty segmentu adresy URL na objekt parametru.

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

Dědičnost: Object

Parameter
RouteParameter

Příklady

Příklady v této části ukazují, jak pomocí RouteParameter objektů v kódu předat hodnoty parametrů adresy URL dotazu, který je určen pro ovládací prvek zdroje dat.

Následující příklad ukazuje kód na stránce Global.asax, který definuje trasu s názvem ProductRoute. Trasa definuje parametr adresy URL s názvem productname. Trasa také definuje volitelný parametr catchall s názvem culture, který lze použít k určení jazyka, ve kterém je zobrazen popis produktu. Požadavky na tuto trasu zpracovává stránka Product.aspx.

Následující příklad ukazuje stránku Product.aspx. Stránka obsahuje ovládací prvek SqlDataSource , který má dotaz, který vyžaduje dva parametry: jeden pro název produktu a druhý pro jazyk popisu produktu. RouteParameter objekty slouží k zadání hodnot parametrů dotazu. Hodnota parametru productname adresy URL trasy se předá parametru @productnamedotazu . Hodnota parametru culture adresy URL trasy se předá parametru @culturedotazu . Pokud adresa URL trasy neobsahuje parametr cultureadresy URL , použije se výchozí hodnota "en".

Následující příklad ukazuje stránku s názvem ProductLinks.aspx, která obsahuje hypertextové odkazy, které odkazují na stránku Product.aspx pomocí adres URL trasy. Tyto hypertextové odkazy používají RouteUrl k vytváření adres URL tras výrazy. První odkaz neobsahuje culture parametr trasy. Proto se v dotazu použije výchozí hodnota "en", která je definována v objektu RouteParameter pro @culture parametr dotazu. Druhý odkaz poskytuje culture hodnotu "fr", což způsobí, že popis se zobrazí ve francouzštině. Další informace o používání RouteUrl výrazů najdete v tématu Postupy: Vytváření adres URL z tras.

Po kliknutí na první hypertextový odkaz se v GridView ovládacím prvku zobrazí stránka Product.aspx s následujícími hodnotami:

ProductID	Název	Description
`994`	`LL Bottom Bracket`	`Chromoly steel.`

Když kliknete na druhý hypertextový odkaz, zobrazí se v ovládacím GridView prvku následující hodnoty:

ProductID	Název	Description
`994`	`LL Bottom Bracket`	`Acier chromé.`

Chcete-li spustit tento příklad, přidejte dvě .aspx stránky a kód v souboru Global.asax do ASP.NET webu nebo webové aplikace, která definuje připojovací řetězec s názvem AdventureWorksLTConnectionString pro databázi AdventureWorksLT. Informace o tom, jak nastavit připojení k databázi AdventureWorksLT, najdete v tématu Postupy: Nastavení ukázkové databáze AdventureWorksLT pro ASP.NET vývoj.

Další informace o směrování ASP.NET najdete v tématu Směrování ASP.NET.

Poznámky

Pokud implementujete ASP.NET směrování na webu, můžete objekt použít RouteParameter k vytvoření vazby hodnoty segmentu požadované adresy URL s databázovým dotazem nebo příkazem. Můžete deklarovat RouteParameter objekty ve značkách pro ovládací prvky zdroje dat nebo ovládací prvek QueryExtender .

K dispozici je projekt webu sady Visual Studio se zdrojovým kódem, který doprovází toto téma: Stáhnout.

Konstruktory

RouteParameter()	Inicializuje novou instanci RouteParameter třídy.
RouteParameter(RouteParameter)	Inicializuje novou instanci RouteParameter třídy pomocí hodnot zadané instance.
RouteParameter(String, DbType, String)	Inicializuje novou instanci RouteParameter třídy pomocí zadaného názvu a typu databáze pro parametr a pomocí zadaného klíče pro data trasy.
RouteParameter(String, String)	Inicializuje novou instanci RouteParameter třídy pomocí zadaného názvu parametru a zadaného klíče pro data trasy.
RouteParameter(String, TypeCode, String)	Inicializuje novou instanci RouteParameter třídy pomocí zadaného názvu a typu parametru a pomocí zadaného klíče pro data trasy.

Vlastnosti

ConvertEmptyStringToNull	Získá nebo nastaví hodnotu určující, zda má být hodnota, na kterou Parameter je objekt vázán, převedena, `null` pokud je Empty. (Zděděno od Parameter)
DbType	Získá nebo nastaví typ databáze parametru. (Zděděno od Parameter)
DefaultValue	Určuje výchozí hodnotu parametru, pokud hodnota, kterou je parametr vázán být neinicializován při Evaluate(HttpContext, Control) zavolání metody. (Zděděno od Parameter)
Direction	Určuje, zda Parameter se objekt používá k vytvoření vazby hodnoty na ovládací prvek, nebo zda lze ovládací prvek použít ke změně hodnoty. (Zděděno od Parameter)
IsTrackingViewState	Získá hodnotu označující, zda Parameter objekt ukládá změny do svého stavu zobrazení. (Zděděno od Parameter)
Name	Získá nebo nastaví název parametru. (Zděděno od Parameter)
RouteKey	Získá nebo nastaví název segmentu trasy, ze kterého chcete načíst hodnotu parametru trasy.
Size	Získá nebo nastaví velikost parametru. (Zděděno od Parameter)
Type	Získá nebo nastaví typ parametru. (Zděděno od Parameter)
ViewState	Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení objektu Parameter více požadavků na stejnou stránku. (Zděděno od Parameter)

Metody

Clone()	Vrátí duplikát aktuální RouteParameter instance.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
Evaluate(HttpContext, Control)	Vyhodnotí adresu URL požadavku a vrátí hodnotu parametru.
GetDatabaseType()	DbType Získá hodnotu, která je ekvivalentní k CLR typ aktuální Parameter instance. (Zděděno od Parameter)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
LoadViewState(Object)	Obnoví dříve uložený stav zobrazení zdroje dat. (Zděděno od Parameter)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnParameterChanged()	Zavolá metodu OnParametersChanged(EventArgs)ParameterCollection kolekce, která obsahuje Parameter objekt. (Zděděno od Parameter)
SaveViewState()	Uloží změny stavu zobrazení objektu Parameter od okamžiku, kdy byla stránka odeslána zpět na server. (Zděděno od Parameter)
SetDirty()	Označí Parameter objekt tak, aby jeho stav byl zaznamenán ve stavu zobrazení. (Zděděno od Parameter)
ToString()	Převede hodnotu této instance na její odpovídající řetězcovou reprezentaci. (Zděděno od Parameter)
TrackViewState()	Způsobí, že Parameter objekt sleduje změny stavu zobrazení, aby je bylo možné uložit do objektu ovládacího prvku ViewState a zachovat v požadavcích na stejnou stránku. (Zděděno od Parameter)

Explicitní implementace rozhraní

ICloneable.Clone()	Vrátí duplikát aktuální Parameter instance. (Zděděno od Parameter)
IStateManager.IsTrackingViewState	Získá hodnotu označující, zda Parameter objekt ukládá změny do svého stavu zobrazení. (Zděděno od Parameter)
IStateManager.LoadViewState(Object)	Obnoví dříve uložený stav zobrazení zdroje dat. (Zděděno od Parameter)
IStateManager.SaveViewState()	Uloží změny stavu zobrazení objektu Parameter od okamžiku, kdy byla stránka odeslána zpět na server. (Zděděno od Parameter)
IStateManager.TrackViewState()	Způsobí, že Parameter objekt sleduje změny stavu zobrazení, aby je bylo možné uložit do objektu ovládacího prvku ViewState a zachovat v požadavcích na stejnou stránku. (Zděděno od Parameter)

Platí pro

Sdílet prostřednictvím