RouteCollection.Add(String, RouteBase) Método

Definición

Espacio de nombres:

System.Web.Routing

Ensamblado:

System.Web.dll

Agrega una ruta al final del objeto RouteCollection y asigna el nombre especificado a la ruta.

public:
 void Add(System::String ^ name, System::Web::Routing::RouteBase ^ item);

public void Add (string name, System.Web.Routing.RouteBase item);

override this.Add : string * System.Web.Routing.RouteBase -> unit

Public Sub Add (name As String, item As RouteBase)

Parámetros

name

String

Valor que identifica la ruta. El valor puede ser null o una cadena vacía.

item

RouteBase

Ruta que se va agregar al final de la colección.

Excepciones

ArgumentNullException

item es null.

ArgumentException

name ya se usa en la colección.

Ejemplos

En el ejemplo siguiente se muestra cómo agregar una ruta a un RouteCollection objeto y asignar un nombre a la ruta.

void Application_Start(object sender, EventArgs e) 
{
    RegisterRoutes(RouteTable.Routes);
}

Sub Application_Start(ByVal sender As Object, ByVal e As EventArgs)
    RegisterRoutes(RouteTable.Routes)
End Sub

Comentarios

El Add método permite definir un nombre para una ruta al agregarlo a la colección de rutas. Al definir un nombre para la ruta, puede especificar una ruta determinada que se usará al usar el enrutamiento para construir una dirección URL. Especificar una ruta determinada es importante cuando más de una ruta coincide con los valores que se pasan al GetVirtualPath método . Si no especifica una ruta con nombre, ASP.NET enrutamiento usará la primera ruta de la colección que coincida con los valores. Para obtener más información, vea Cómo: Construir direcciones URL a partir de rutas.

Un nombre solo se puede usar una vez en el RouteCollection objeto .

Si no tiene que especificar un nombre para la ruta, puede agregar la ruta llamando al Add método .

Use el GetReadLock método y el GetWriteLock método para asegurarse de interactuar con la colección sin conflictos de otros procesos.

Consulte también

• Enrutamiento de ASP.NET