RouteCollection.Ignore Метод

  • Ссылка

Определение

Пространство имен:
System.Web.Routing
Сборка:
System.Web.dll

Определяет шаблон URL-адреса, который не следует проверять на соответствия маршрутам.

Перегрузки

Ignore(String, Object)

Определяет шаблон URL-адреса, который не следует проверять на соответствия маршрутам, если URL-адрес запроса соответствует указанным ограничениям.
Ignore(String)

Определяет шаблон URL-адреса, который не следует проверять на соответствия маршрутам.

Комментарии

Этот метод создает маршрут, который сопоставляется с обработчиком StopRoutingHandler маршрутов. После вызова этого метода запросы, соответствующие указанному шаблону URL-адреса, не будут обрабатываться как запросы маршрутизации.

ASP.NET маршрутизация автоматически игнорирует запросы, если URL-адрес соответствует физическому файлу, например файлу изображения. В некоторых случаях также может потребоваться, чтобы маршрутизация пропускала запросы, если нет физического файла. Например, запросы, которые ASP.NET автоматически выполняет для AXD-файлов, не следует рассматривать как запросы маршрута, даже если нет физического файла, соответствующего расширению AXD.

Ignore(String, Object)

Определяет шаблон URL-адреса, который не следует проверять на соответствия маршрутам, если URL-адрес запроса соответствует указанным ограничениям.

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)

Параметры

url
String

Шаблон URL-адреса, который следует игнорировать.

constraints
Object

Дополнительные критерии, определяющие, будет ли игнорироваться запрос, соответствующий шаблону URL-адреса.

Исключения

ArgumentNullException

Параметр url имеет значение null.

Примеры

В следующем примере показано, как использовать этот метод для игнорирования всех URL-адресов с расширением ASPX. Это может потребоваться, если вы регистрируете пользовательский обработчик HTTP для обработки всех URL-адресов для файлов с расширением ".aspx". Для одного шаблона URL-адреса, соответствующего всем ASPX-запросам, потребуется два параметра catchall, {*path}.aspx/{*pathinfo}например . (Этот шаблон будет соответствовать любому URL-адресу, который заканчивается на ASPX, включая те, которые имеют параметры строки запроса.) Однако маршрутизация позволяет использовать только один параметр catchall в конце. В качестве альтернативы можно указать шаблон URL-адреса с одним параметром catchall, который соответствует всем URL-адресам, а затем указать ограничения, исключающие все, у которых нет расширения ASPX, как показано в следующем примере:

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

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

Предыдущая строка кода обычно добавляется в метод, вызываемый из Application_Start метода в Global.asax, как показано в примере перегрузки Ignore(String) .

Комментарии

Этот метод создает маршрут, который сопоставляется с обработчиком StopRoutingHandler маршрутов. После вызова этого метода запросы, соответствующие указанному шаблону URL-адреса, не будут обрабатываться как запросы маршрутизации.

ASP.NET маршрутизация автоматически игнорирует запросы, если URL-адрес соответствует физическому файлу, например файлу изображения. В некоторых случаях также может потребоваться, чтобы маршрутизация пропускала запросы, если нет физического файла. Например, запросы, которые ASP.NET автоматически выполняет для AXD-файлов, не следует рассматривать как запросы маршрута, даже если нет физического файла, соответствующего расширению AXD.

См. также раздел

Применяется к

Ignore(String)

Определяет шаблон URL-адреса, который не следует проверять на соответствия маршрутам.

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

Параметры

url
String

Шаблон URL-адреса, который следует игнорировать.

Примеры

Шаблон по умолчанию для проектов MVC использует этот метод для исключения AXD-файлов из маршрутизации, как показано в следующем примере:

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

Комментарии

Этот метод создает маршрут, который сопоставляется с обработчиком StopRoutingHandler маршрутов. После вызова этого метода запросы, соответствующие указанному шаблону URL-адреса, не будут обрабатываться как запросы маршрутизации.

ASP.NET маршрутизация автоматически игнорирует запросы, если URL-адрес соответствует физическому файлу, например файлу изображения. В некоторых случаях также может потребоваться, чтобы маршрутизация пропускала запросы, если нет физического файла. Например, запросы, которые ASP.NET автоматически выполняет для AXD-файлов, не следует рассматривать как запросы маршрута, даже если нет физического файла, соответствующего расширению AXD.

См. также раздел

Применяется к