RouteCollection.Add(String, RouteBase) Método

Definição

Namespace:

System.Web.Routing

Assembly:

System.Web.dll

Adiciona uma rota para o fim do objeto RouteCollection 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 de caracteres vazia.

item

RouteBase

A rota para adicionar ao final da coleção.

Exceções

ArgumentNullException

item é null.

ArgumentException

name já é usado na coleção.

Exemplos

O exemplo a seguir 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

Comentários

O Add método permite que você defina um nome para uma rota ao adicioná-la à coleção de rotas. Ao definir um nome para a rota, você pode especificar uma rota específica a ser usada ao usar o roteamento para construir uma URL. Especificar uma rota específica é importante quando mais de uma rota corresponde aos valores que você passa para o GetVirtualPath método . Se você não especificar uma rota nomeada, ASP.NET roteamento usará a primeira rota na coleção que corresponde aos valores. Para obter mais informações, consulte Como construir URLs a partir de rotas.

Um nome pode ser usado apenas uma vez no RouteCollection objeto .

Se você não precisar especificar um nome para a rota, poderá adicionar a rota chamando o Add método .

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

Confira também

• Roteamento do ASP.NET