RouteCollection.Add(String, RouteBase) Metoda

Definice

Obor názvů:

System.Web.Routing

Sestavení:

System.Web.dll

Přidá trasu na konec objektu RouteCollection a přiřadí trasě zadaný název.

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)

Parametry

name

String

Hodnota, která identifikuje trasu. Hodnota může být null nebo prázdný řetězec.

item

RouteBase

Trasa, která se má přidat na konec kolekce.

Výjimky

ArgumentNullException

item je null.

ArgumentException

name se už v kolekci používá.

Příklady

Následující příklad ukazuje, jak přidat trasu k objektu RouteCollection a přiřadit název trasy.

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

Poznámky

Metoda Add umožňuje definovat název trasy, když ji přidáte do kolekce tras. Definováním názvu trasy můžete určit konkrétní trasu, která se má použít při použití směrování k vytvoření adresy URL. Zadání konkrétní trasy je důležité, pokud více než jedna trasa odpovídá hodnotám, které předáte GetVirtualPath metodě. Pokud nezadáte pojmenovanou trasu, ASP.NET směrování použije první trasu v kolekci, která odpovídá hodnotám. Další informace najdete v tématu Postupy: Vytváření adres URL z tras.

Název lze v objektu RouteCollection použít pouze jednou.

Pokud není nutné zadat název trasy, můžete přidat trasu voláním Add metody .

GetReadLock Pomocí metody a GetWriteLock metody se ujistěte, že pracujete s kolekcí bez konfliktů z jiných procesů.

Viz také

• směrování ASP.NET