RouteParameter Clase

Definición

Enlaza el valor de un segmento de dirección URL a un objeto de parámetro.

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

Ejemplos

Los ejemplos de esta sección muestran cómo usar RouteParameter objetos en el marcado para pasar valores de parámetros de dirección URL a una consulta especificada para un control de origen de datos.

En el ejemplo siguiente se muestra código en la página Global.asax que define una ruta denominada ProductRoute. La ruta define un parámetro de dirección URL denominado productname. La ruta también define un parámetro catchall opcional denominado culture, que se puede usar para especificar el idioma en el que se muestra la descripción del producto. La página Product.aspx controla las solicitudes de esta ruta.

En el ejemplo siguiente se muestra la página Product.aspx. La página contiene un SqlDataSource control que tiene una consulta que requiere dos parámetros, uno para el nombre del producto y otro para el idioma de la descripción del producto. RouteParameter Los objetos se usan para proporcionar los valores de los parámetros de consulta. El valor del parámetro productname route URL se pasa al parámetro @productnamede consulta . El valor del parámetro culture route URL se pasa al parámetro @culturede consulta . Si una dirección URL de ruta no incluye el parámetro cultureURL , se usa un valor predeterminado de "en".

En el ejemplo siguiente se muestra una página denominada ProductLinks.aspx, que contiene hipervínculos que se vinculan a la página Product.aspx mediante direcciones URL de ruta. Estos hipervínculos usan RouteUrl expresiones para crear direcciones URL de ruta. El primer vínculo no incluye un culture parámetro de ruta. Por lo tanto, el valor predeterminado de "en" que se define en el objeto para @culture el RouteParameter parámetro de consulta se usará en la consulta. El segundo vínculo proporciona un culture valor de "fr", lo que hace que la descripción se muestre en francés. Para obtener más información sobre cómo usar RouteUrl expresiones, vea Cómo: Construir direcciones URL a partir de rutas.

Al hacer clic en el primer hipervínculo, verá la página Product.aspx con los siguientes valores en el GridView control :

ProductID Nombre Descripción
994 LL Bottom Bracket Chromoly steel.

Al hacer clic en el segundo hipervínculo, verá los siguientes valores en el GridView control :

ProductID Nombre Descripción
994 LL Bottom Bracket Acier chromé.

Para ejecutar este ejemplo, agregue las dos páginas .aspx y el código del archivo Global.asax a un sitio web o aplicación web de ASP.NET que defina una cadena de conexión denominada AdventureWorksLTConnectionString para la base de datos AdventureWorksLT. Para obtener información sobre cómo configurar una conexión a la base de datos AdventureWorksLT, vea How to: Set Up an AdventureWorksLT Sample Database for ASP.NET Development.

Para obtener más información sobre el enrutamiento de ASP.NET, consulte enrutamiento de ASP.NET.

Comentarios

Si implementa ASP.NET enrutamiento en un sitio web, puede usar el RouteParameter objeto para enlazar el valor de un segmento de la dirección URL solicitada a una consulta o comando de base de datos. Puede declarar RouteParameter objetos en marcado para los controles de origen de datos o el QueryExtender control .

Hay disponible un proyecto de sitio web de Visual Studio con código fuente para acompañar este tema: Descargar.

Constructores

RouteParameter()

Inicializa una nueva instancia de la clase RouteParameter.

RouteParameter(RouteParameter)

Inicializa una nueva instancia de la clase RouteParameter usando los valores de la instancia especificada.

RouteParameter(String, DbType, String)

Inicializa una nueva instancia de la clase RouteParameter usando el nombre y el tipo de base de datos especificados del parámetro así como la clave especificada de los datos de ruta.

RouteParameter(String, String)

Inicializa una nueva instancia de la clase RouteParameter usando el nombre especificado del parámetro y la clave especificada de los datos de ruta.

RouteParameter(String, TypeCode, String)

Inicializa una nueva instancia de la clase RouteParameter usando el nombre y el tipo especificados del parámetro así como la clave especificada de los datos de ruta.

Propiedades

ConvertEmptyStringToNull

Obtiene o establece un valor que indica si el valor al que está enlazado el objeto Parameter debe convertirse a null si es Empty.

(Heredado de Parameter)
DbType

Obtiene o establece el tipo de base de datos del parámetro.

(Heredado de Parameter)
DefaultValue

Especifica un valor predeterminado para el parámetro, si el valor al que está enlazado el parámetro no debe estar inicializado cuando se llame al método Evaluate(HttpContext, Control).

(Heredado de Parameter)
Direction

Indica si el objeto Parameter se utiliza para enlazar un valor a un control o si se puede utilizar el control para cambiar el valor.

(Heredado de Parameter)
IsTrackingViewState

Obtiene un valor que indica si el objeto Parameter está guardando los cambios en su estado de vista.

(Heredado de Parameter)
Name

Obtiene o establece el nombre del parámetro.

(Heredado de Parameter)
RouteKey

Obtiene o establece el nombre del segmento de ruta del que se va a recuperar el valor del parámetro de ruta.

Size

Obtiene o establece el tamaño del parámetro.

(Heredado de Parameter)
Type

Obtiene o establece el tipo de parámetro.

(Heredado de Parameter)
ViewState

Obtiene un diccionario con información de estado que permite guardar y restaurar el estado de vista de un objeto Parameter en las distintas solicitudes de la misma página.

(Heredado de Parameter)

Métodos

Clone()

Devuelve un duplicado de la instancia RouteParameter actual.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
Evaluate(HttpContext, Control)

Evalúa la dirección URL de la solicitud y devuelve el valor del parámetro.

GetDatabaseType()

Obtiene el valor DbType que es equivalente al tipo CLR de la instancia Parameter actual.

(Heredado de Parameter)
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
LoadViewState(Object)

Restaura la vista del origen de datos tal y como se guardó previamente.

(Heredado de Parameter)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
OnParameterChanged()

Llama al método OnParametersChanged(EventArgs) de la colección ParameterCollection que contiene el objeto Parameter.

(Heredado de Parameter)
SaveViewState()

Guarda los cambios realizados en el estado de la vista del objeto Parameter desde el momento en que se devolvió la página al servidor.

(Heredado de Parameter)
SetDirty()

Marca el objeto Parameter para que su estado se registre en el estado de vista.

(Heredado de Parameter)
ToString()

Convierte el valor de esta instancia en la representación de cadena equivalente.

(Heredado de Parameter)
TrackViewState()

Hace que el objeto Parameter realice el seguimiento de los cambios en su estado de vista, de modo que puedan almacenarse en el objeto ViewState del control y mantenerse en todas las solicitudes de la misma página.

(Heredado de Parameter)

Implementaciones de interfaz explícitas

ICloneable.Clone()

Devuelve un duplicado de la instancia Parameter actual.

(Heredado de Parameter)
IStateManager.IsTrackingViewState

Obtiene un valor que indica si el objeto Parameter está guardando los cambios en su estado de vista.

(Heredado de Parameter)
IStateManager.LoadViewState(Object)

Restaura la vista del origen de datos tal y como se guardó previamente.

(Heredado de Parameter)
IStateManager.SaveViewState()

Guarda los cambios realizados en el estado de la vista del objeto Parameter desde el momento en que se devolvió la página al servidor.

(Heredado de Parameter)
IStateManager.TrackViewState()

Hace que el objeto Parameter realice el seguimiento de los cambios en su estado de vista, de modo que puedan almacenarse en el objeto ViewState del control y mantenerse en todas las solicitudes de la misma página.

(Heredado de Parameter)

Se aplica a

Consulte también