Condividi tramite

RouteCollection.Ignore Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.Routing
Assembly:
System.Web.dll

Definisce un modello di URL che non deve essere verificato per corrispondenze rispetto alle route.

Overload

Ignore(String, Object)

Definisce un modello di URL che non deve essere verificato per corrispondenze rispetto alle route se un URL della richiesta soddisfa i vincoli specificati.
Ignore(String)

Definisce un modello di URL che non deve essere verificato per corrispondenze rispetto alle route.

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.

Ignore(String, Object)

Definisce un modello di URL che non deve essere verificato per corrispondenze rispetto alle route se un URL della richiesta soddisfa i vincoli specificati.

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

url
String

Il modello di URL da ignorare.

constraints
Object

Criteri aggiuntivi che determinano se sarà ignorata una richiesta che corrisponde al modello di URL.

Eccezioni

ArgumentNullException

Il valore del parametro url è null.

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

Si applica a

Ignore(String)

Definisce un modello di URL che non deve essere verificato per corrispondenze rispetto alle route.

public:
 void Ignore(System::String ^ url);
public void Ignore (string url);
member this.Ignore : string -> unit
Public Sub Ignore (url As String)

Parametri

url
String

Il modello di URL da ignorare.

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

Si applica a