Udostępnij za pośrednictwem


RouteParameter Klasa

Definicja

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
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

Zobacz też