Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo RouteCollection.Ignore (String, Object)

.NET Framework (current version)
 

Data di pubblicazione: ottobre 2016

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

Spazio dei nomi:   System.Web.Routing
Assembly:  System.Web (in System.Web.dll)

public void Ignore(
	string url,
	object constraints
)

Parametri

url
Type: System.String

Il modello di URL che verranno ignorati.

constraints
Type: System.Object

Criteri aggiuntivi per determinare se una richiesta che corrisponde al modello di URL verrà ignorata.

Exception Condition
ArgumentNullException

Il valore del parametro url è null.

Questo metodo crea una route che viene eseguito il mapping per il StopRoutingHandler gestore di route. Dopo aver chiamato questo metodo, le richieste che corrispondono al modello di URL specificato non verranno elaborate come instradare le richieste.

Il routing ASP.NET ignora automaticamente le richieste quando l'URL corrisponde a un file fisico, ad esempio un file di immagine. In alcuni casi è inoltre possibile routing ignori le richieste quando non esiste alcun file fisico. Ad esempio, le richieste ASP.NET rende automaticamente per i file con estensione axd non considerare come instradare le richieste anche se non esiste alcun file fisico che corrisponde all'estensione axd.

Nell'esempio seguente viene illustrato come utilizzare questo metodo per ignorare tutti gli URL che hanno l'estensione aspx. Si desidera 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 corrisponda a tutte le richieste. aspx richiederebbe due parametri catchall quali {*path}.aspx/{*pathinfo}. (Questo modello corrisponderebbe a qualsiasi URL che termina in. aspx, inclusi quelli che dispongono di parametri di stringa di query.) Tuttavia, di routing consente un solo parametro catchall alla fine. In alternativa, è possibile specificare un modello di URL che presenta un singolo parametro catchall che corrisponde a tutti gli URL e quindi specificare i vincoli che escludano tutto ciò che ha l'estensione aspx, come illustrato nell'esempio seguente:

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

Aggiunta in genere la riga di codice precedente a un metodo da cui viene chiamato il Application_Start metodo in Global. asax, come illustrato nell'esempio per il Ignore(String) overload.

.NET Framework
Disponibile da 4.0
Torna all'inizio
Mostra: