RouteParameter Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Enlaza el valor de un segmento de dirección URL a un objeto de parámetro.
public ref class RouteParameter : System::Web::UI::WebControls::Parameterpublic class RouteParameter : System.Web.UI.WebControls.Parametertype RouteParameter = class
inherit ParameterPublic Class RouteParameter
Inherits Parameter- Herencia
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 de .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 |
| 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) |
