RouteCollection.Add(String, RouteBase) Metodo

Definizione

Spazio dei nomi:

System.Web.Routing

Assembly:

System.Web.dll

Aggiunge una route alla fine dell'oggetto RouteCollection e assegna il nome specificato alla route.

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)

Parametri

name

String

Valore che identifica la route. Il valore può essere null o una stringa vuota.

item

RouteBase

Route da aggiungere al termine della raccolta.

Eccezioni

ArgumentNullException

item è null.

ArgumentException

name è già usato nella raccolta.

Esempio

Nell'esempio seguente viene illustrato come aggiungere una route a un RouteCollection oggetto e assegnare un nome alla route.

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

Commenti

Il Add metodo consente di definire un nome per una route quando viene aggiunto alla raccolta di route. Definendo un nome per la route, è possibile specificare una route specifica da usare quando si usa il routing per costruire un URL. Specificare una route specifica è importante quando più route corrispondono ai valori passati al GetVirtualPath metodo . Se non si specifica una route denominata, ASP.NET routing userà la prima route nella raccolta che corrisponde ai valori. Per altre informazioni, vedere Procedura: Costruire URL da route.

Un nome può essere utilizzato una sola volta nell'oggetto RouteCollection .

Se non è necessario specificare un nome per la route, è possibile aggiungere la route chiamando il Add metodo .

Usare il GetReadLock metodo e il GetWriteLock metodo per assicurarsi di interagire con la raccolta senza conflitti da altri processi.

Vedi anche

• Routing di ASP.NET