RouteParameter Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Wiąże wartość segmentu adresu URL z obiektem 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

Dziedziczenie: Object

Parameter
RouteParameter

Przykłady

W przykładach w tej sekcji pokazano, jak używać RouteParameter obiektów w znacznikach do przekazywania wartości parametrów adresu URL do zapytania określonego dla kontroli źródła danych.

W poniższym przykładzie pokazano kod na stronie Global.asax, który definiuje trasę o nazwie ProductRoute. Trasa definiuje parametr adresu URL o nazwie productname. Trasa definiuje również opcjonalny parametr catchall o nazwie culture, który może służyć do określania języka, w którym jest wyświetlany opis produktu. Strona Product.aspx obsługuje żądania dla tej trasy.

Poniższy przykład przedstawia stronę Product.aspx. Strona zawiera kontrolkę SqlDataSource , która zawiera zapytanie, które wymaga dwóch parametrów, jeden dla nazwy produktu i jeden dla języka opisu produktu. RouteParameter obiekty służą do podawania wartości parametrów zapytania. Wartość parametru productname adresu URL trasy jest przekazywana do parametru @productnamezapytania . Wartość parametru culture adresu URL trasy jest przekazywana do parametru @culturezapytania . Jeśli adres URL trasy nie zawiera parametru cultureadresu URL, zostanie użyta domyślna wartość "en".

W poniższym przykładzie przedstawiono stronę o nazwie ProductLinks.aspx zawierającą hiperlinki, które łączą się ze stroną Product.aspx przy użyciu adresów URL tras. Te hiperlinki używają RouteUrl wyrażeń do tworzenia adresów URL tras. Pierwszy link nie zawiera parametru culture trasy. W związku z tym wartość domyślna "en" zdefiniowana w RouteParameter obiekcie dla @culture parametru zapytania będzie używana w zapytaniu. Drugi link zawiera culture wartość "fr", co powoduje wyświetlenie opisu w języku francuskim. Aby uzyskać więcej informacji na temat używania RouteUrl wyrażeń, zobacz Instrukcje: konstruowanie adresów URL z tras.

Po kliknięciu pierwszego hiperłącza zostanie wyświetlona strona Product.aspx z następującymi wartościami w kontrolce GridView :

ProductID	Nazwa	Opis
`994`	`LL Bottom Bracket`	`Chromoly steel.`

Po kliknięciu drugiego hiperłącza w kontrolce GridView są widoczne następujące wartości:

ProductID	Nazwa	Opis
`994`	`LL Bottom Bracket`	`Acier chromé.`

Aby uruchomić ten przykład, dodaj dwie strony aspx i kod w pliku Global.asax do witryny sieci Web ASP.NET lub aplikacji internetowej, która definiuje parametry połączenia o nazwie AdventureWorksLTConnectionString dla bazy danych AdventureWorksLT. Aby uzyskać informacje o sposobie konfigurowania połączenia z bazą danych AdventureWorksLT, zobacz How to: Set Up an AdventureWorksLT Sample Database for ASP.NET Development (Instrukcje: konfigurowanie przykładowej bazy danych AdventureWorksLT na potrzeby tworzenia ASP.NET).

Aby uzyskać więcej informacji na temat routingu ASP.NET, zobacz ASP.NET Routing.

Uwagi

W przypadku implementacji routingu ASP.NET w witrynie sieci Web można użyć RouteParameter obiektu, aby powiązać wartość segmentu żądanego adresu URL z zapytaniem bazy danych lub poleceniem. Obiekty można zadeklarować RouteParameter w znacznikach dla kontrolek źródła danych lub kontrolki QueryExtender .

Projekt witryny sieci Web programu Visual Studio z kodem źródłowym jest dostępny do dołączenia do tego tematu: Pobierz.

Konstruktory

RouteParameter()	Inicjuje nowe wystąpienie klasy RouteParameter.
RouteParameter(RouteParameter)	Inicjuje RouteParameter nowe wystąpienie klasy przy użyciu wartości określonego wystąpienia.
RouteParameter(String, DbType, String)	Inicjuje nowe wystąpienie RouteParameter klasy przy użyciu określonej nazwy i typu bazy danych dla parametru oraz przy użyciu określonego klucza dla danych trasy.
RouteParameter(String, String)	Inicjuje nowe wystąpienie RouteParameter klasy przy użyciu określonej nazwy parametru i określonego klucza dla danych trasy.
RouteParameter(String, TypeCode, String)	Inicjuje nowe wystąpienie RouteParameter klasy przy użyciu określonej nazwy i typu parametru oraz przy użyciu określonego klucza dla danych trasy.

Właściwości

ConvertEmptyStringToNull	Pobiera lub ustawia wartość wskazującą, Parameter czy wartość, którą obiekt jest powiązany, powinna zostać przekonwertowana na `null` wartość , jeśli jest Emptyto . (Odziedziczone po Parameter)
DbType	Pobiera lub ustawia typ bazy danych parametru. (Odziedziczone po Parameter)
DefaultValue	Określa wartość domyślną parametru, jeśli wartość parametru jest powiązana z niezainicjowaną, gdy Evaluate(HttpContext, Control) metoda jest wywoływana. (Odziedziczone po Parameter)
Direction	Wskazuje, czy Parameter obiekt jest używany do powiązania wartości z kontrolką, czy kontrolki można użyć do zmiany wartości. (Odziedziczone po Parameter)
IsTrackingViewState	Pobiera wartość wskazującą, czy Parameter obiekt zapisuje zmiany w stanie widoku. (Odziedziczone po Parameter)
Name	Pobiera lub ustawia nazwę parametru. (Odziedziczone po Parameter)
RouteKey	Pobiera lub ustawia nazwę segmentu trasy, z którego ma być pobierana wartość parametru trasy.
Size	Pobiera lub ustawia rozmiar parametru. (Odziedziczone po Parameter)
Type	Pobiera lub ustawia typ parametru. (Odziedziczone po Parameter)
ViewState	Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu Parameter widoku obiektu na wielu żądaniach dla tej samej strony. (Odziedziczone po Parameter)

Metody

Clone()	Zwraca duplikat bieżącego RouteParameter wystąpienia.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
Evaluate(HttpContext, Control)	Oblicza adres URL żądania i zwraca wartość parametru.
GetDatabaseType()	DbType Pobiera wartość równoważną typowi CLR bieżącego Parameter wystąpienia. (Odziedziczone po Parameter)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
LoadViewState(Object)	Przywraca wcześniej zapisany stan widoku źródła danych. (Odziedziczone po Parameter)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnParameterChanged()	Wywołuje metodę OnParametersChanged(EventArgs) kolekcji ParameterCollection zawierającej Parameter obiekt. (Odziedziczone po Parameter)
SaveViewState()	Zapisuje zmiany w Parameter stanie widoku obiektu od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po Parameter)
SetDirty()	Oznacza obiekt tak Parameter , aby jego stan był rejestrowany w stanie widoku. (Odziedziczone po Parameter)
ToString()	Konwertuje wartość tego wystąpienia na jego równoważną reprezentację w postaci ciągu. (Odziedziczone po Parameter)
TrackViewState()	Parameter Powoduje, że obiekt śledzi zmiany w stanie widoku, dzięki czemu można je przechowywać w obiekcie kontrolki ViewState i utrwalać w żądaniach dla tej samej strony. (Odziedziczone po Parameter)

Jawne implementacje interfejsu

ICloneable.Clone()	Zwraca duplikat bieżącego Parameter wystąpienia. (Odziedziczone po Parameter)
IStateManager.IsTrackingViewState	Pobiera wartość wskazującą, czy Parameter obiekt zapisuje zmiany w stanie widoku. (Odziedziczone po Parameter)
IStateManager.LoadViewState(Object)	Przywraca wcześniej zapisany stan widoku źródła danych. (Odziedziczone po Parameter)
IStateManager.SaveViewState()	Zapisuje zmiany w Parameter stanie widoku obiektu od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po Parameter)
IStateManager.TrackViewState()	Parameter Powoduje, że obiekt śledzi zmiany w stanie widoku, dzięki czemu można je przechowywać w obiekcie kontrolki ViewState i utrwalać w żądaniach dla tej samej strony. (Odziedziczone po Parameter)

Dotyczy