RouteCollection.Ignore Metodo

public:
 void Ignore(System::String ^ url, System::Object ^ constraints);

public void Ignore (string url, object constraints);

member this.Ignore : string * obj -> unit

Public Sub Ignore (url As String, constraints As Object)

Parametri

Eccezioni

Esempio

Nell'esempio seguente viene illustrato come usare questo metodo per ignorare tutti gli URL con estensione .aspx. È possibile eseguire questa operazione se si registra un gestore HTTP personalizzato per gestire tutti gli URL per i file con estensione ".aspx". Un singolo modello di URL che corrisponde a tutte le richieste di .aspx richiederebbe due parametri catchall, ad {*path}.aspx/{*pathinfo}esempio . Questo modello corrisponde a qualsiasi URL che termina in .aspx, inclusi quelli con parametri di stringa di query. Tuttavia, il routing consente un solo parametro catchall alla fine. In alternativa, è possibile specificare un modello url con un singolo parametro catchall che corrisponde a tutti gli URL e quindi specificare vincoli che escludono tutti gli elementi che non dispongono dell'estensione .aspx, come illustrato nell'esempio seguente:

routes.Ignore("{*allaspx}", new With {.allaspx = ".*\.aspx(/.*)?"})

routes.Ignore("{*allaspx}", new {allaspx=@".*\.aspx(/.*)?"});

La riga di codice precedente viene in genere aggiunta a un metodo chiamato dal Application_Start metodo in Global.asax, come illustrato nell'esempio per l'overload Ignore(String) .

Commenti

Questo metodo crea una route mappata al StopRoutingHandler gestore di route. Dopo aver chiamato questo metodo, le richieste che corrispondono al modello di URL specificato non verranno elaborate come richieste di route.

ASP.NET routing ignora automaticamente le richieste quando l'URL corrisponde a un file fisico, ad esempio un file di immagine. In alcuni casi è anche possibile che il routing ignori le richieste quando non è presente alcun file fisico. Ad esempio, le richieste che ASP.NET effettua automaticamente per i file con estensione axd non devono essere considerate richieste di route, anche se non è presente alcun file fisico che corrisponde all'estensione con estensione axd.

Vedi anche

• Routing di ASP.NET

public:
 void Ignore(System::String ^ url);

public void Ignore (string url);

member this.Ignore : string -> unit

Public Sub Ignore (url As String)

Parametri

Esempio

Il modello predefinito per i progetti MVC usa questo metodo per escludere i file con estensione axd dal routing, come illustrato nell'esempio seguente:

public class MvcApplication : System.Web.HttpApplication
{
    public static void RegisterRoutes(RouteCollection routes)
    {
        routes.IgnoreRoute("{resource}.axd/{*pathInfo}");

        routes.MapRoute(
            "Default",                                              // Route name
            "{controller}/{action}/{id}",                           // URL with parameters
            new { controller = "Home", action = "Index", id = "" }  // Parameter defaults
        );
    }

    protected void Application_Start()
    {
        RegisterRoutes(RouteTable.Routes);
    }
}

Public Class MvcApplication
    Inherits System.Web.HttpApplication

    Shared Sub RegisterRoutes(ByVal routes As RouteCollection)
        routes.IgnoreRoute("{resource}.axd/{*pathInfo}")

        ' MapRoute takes the following parameters, in order:
        ' (1) Route name
        ' (2) URL with parameters
        ' (3) Parameter defaults
        routes.MapRoute( _
            "Default", _
            "{controller}/{action}/{id}", _
            New With {.controller = "Home", .action = "Index", .id = ""} _
        )

    End Sub

    Sub Application_Start()
        RegisterRoutes(RouteTable.Routes)
    End Sub
End Class

Commenti

Questo metodo crea una route mappata al StopRoutingHandler gestore di route. Dopo aver chiamato questo metodo, le richieste che corrispondono al modello di URL specificato non verranno elaborate come richieste di route.

ASP.NET routing ignora automaticamente le richieste quando l'URL corrisponde a un file fisico, ad esempio un file di immagine. In alcuni casi è anche possibile che il routing ignori le richieste quando non è presente alcun file fisico. Ad esempio, le richieste che ASP.NET effettua automaticamente per i file con estensione axd non devono essere considerate richieste di route, anche se non è presente alcun file fisico che corrisponde all'estensione con estensione axd.

Vedi anche

• Routing di ASP.NET