RouteCollection.Add(String, RouteBase) Método

Definição

Espaço de Nomes:
System.Web.Routing
Assemblagem:
System.Web.Routing.dll
Assemblagem:
System.Web.dll

Adiciona uma rota ao final do RouteCollection objeto e atribui o nome especificado à rota.

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

O valor que identifica a rota. O valor pode ser null ou uma cadeia vazia.

item
RouteBase

O caminho para acrescentar ao final da coleção.

Exceções

ArgumentNullException

item é null.

ArgumentException

name já é utilizado na coleção.

Exemplos

O exemplo seguinte mostra como adicionar uma rota a um RouteCollection objeto e atribuir um nome à rota.

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

Observações

O Add método permite-lhe definir um nome para uma rota quando a adiciona à coleção de rotas. Ao definir um nome para a rota, pode especificar uma rota específica a usar quando usar roteamento para construir uma URL. Especificar uma rota específica é importante quando mais do que uma rota corresponde aos valores que passa ao GetVirtualPath método. Se não especificar uma rota nomeada, o encaminhamento ASP.NET usará a primeira rota da coleção que corresponde aos valores. Para mais informações, veja Como: Construir URLs a partir de Rotas.

Um nome só pode ser usado uma vez no RouteCollection objeto.

Se não for necessário especificar um nome para a rota, pode adicioná-la chamando o Add método.

Use o GetReadLock método e o GetWriteLock método para garantir que interage com a coleção sem conflitos de outros processos.

Aplica-se a

Ver também