RouteCollection.Add(String, RouteBase) Metod

Definition

Namnområde:
System.Web.Routing
Sammansättning:
System.Web.Routing.dll
Sammansättning:
System.Web.dll

Lägger till en väg i slutet av RouteCollection objektet och tilldelar det angivna namnet till vägen.

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)

Parametrar

name
String

Värdet som identifierar vägen. Värdet kan vara null eller en tom sträng.

item
RouteBase

Den väg som ska läggas till i slutet av samlingen.

Undantag

ArgumentNullException

item är null.

ArgumentException

name används redan i samlingen.

Exempel

I följande exempel visas hur du lägger till en väg till ett RouteCollection objekt och tilldelar ett namn till vägen.

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

Kommentarer

Med Add metoden kan du definiera ett namn för en väg när du lägger till den i routningssamlingen. Genom att definiera ett namn för vägen kan du ange en viss väg som ska användas när du använder routning för att skapa en URL. Det är viktigt att ange en viss väg när mer än en väg matchar de värden som du skickar till GetVirtualPath metoden. Om du inte anger en namngiven väg använder ASP.NET routning den första vägen i samlingen som matchar värdena. Mer information finns i Så här skapar du URL:er från vägar.

Ett namn kan bara användas en gång i objektet RouteCollection .

Om du inte behöver ange ett namn för vägen kan du lägga till vägen genom att anropa Add metoden.

GetReadLock Använd metoden och GetWriteLock metoden för att se till att du interagerar med samlingen utan konflikter från andra processer.

Gäller för

Se även