RouteParameter Třída
Definice
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
Příklady
Příklady v této části ukazují, jak použít RouteParameter objekty ve značkách k předání hodnot 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. Stránka Product.aspx zpracovává požadavky na tuto trasu.
Následující příklad ukazuje stránku Product.aspx. Stránka obsahuje SqlDataSource ovládací prvek s dotazem, 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 @productname
dotazu . Hodnota parametru culture
adresy URL trasy se předá parametru @culture
dotazu . Pokud adresa URL trasy neobsahuje parametr culture
adresy 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
výrazy k vytvoření adres URL tras. První odkaz neobsahuje culture
parametr trasy. Proto se v dotazu použije výchozí hodnota "en", která je definovaná 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. |
Po kliknutí na druhý hypertextový odkaz se v ovládacím GridView prvku zobrazí následující hodnoty:
ProductID | Název | Description |
---|---|---|
994 |
LL Bottom Bracket |
Acier chromé. |
Chcete-li spustit tento příklad, přidejte dvě stránky .aspx a kód v souboru Global.asax na web ASP.NET nebo webovou aplikaci, 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 použít RouteParameter objekt k vytvoření vazby hodnoty segmentu požadované adresy URL na databázový dotaz nebo příkaz. Můžete deklarovat RouteParameter objekty v kódu pro ovládací prvky zdroje dat nebo ovládací prvek QueryExtender .
Projekt webu sady Visual Studio se zdrojovým kódem je k dispozici pro 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 označující, zda má být hodnota, se kterou Parameter je objekt vázán, převedena na |
DbType |
Získá nebo nastaví typ databáze parametru. (Zděděno od Parameter) |
DefaultValue |
Určuje výchozí hodnotu parametru, pokud by 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 se Parameter 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 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 rámci 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í typu CLR aktuální Parameter instance. (Zděděno od Parameter) |
GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
GetType() |
Type Získá z aktuální instance. (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() |
Volá 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 se jeho stav zaznamenal 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 mohly být uloženy v objektu ovládacího prvku ViewState a trvale zachovány 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 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 mohly být uloženy v objektu ovládacího prvku ViewState a trvale zachovány v požadavcích na stejnou stránku. (Zděděno od Parameter) |
Platí pro
Viz také
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro