다음을 통해 공유

RouteCollection.Ignore 메서드

  • 참조

정의

네임스페이스:
System.Web.Routing
어셈블리:
System.Web.dll

경로에 대해 일치 여부를 확인하지 않아야 하는 URL 패턴을 정의합니다.

오버로드

Ignore(String, Object)

요청 URL이 지정된 제약 조건을 충족하는 경우 경로에 대한 일치 여부를 확인하지 않아야 하는 URL 패턴을 정의합니다.
Ignore(String)

경로에 대해 일치 여부를 확인하지 않아야 하는 URL 패턴을 정의합니다.

설명

이 메서드는 경로 처리기에 매핑 StopRoutingHandler 되는 경로를 만듭니다. 이 메서드를 호출한 후에는 지정된 URL 패턴과 일치하는 요청이 경로 요청으로 처리되지 않습니다.

ASP.NET 라우팅은 URL이 이미지 파일과 같은 실제 파일과 일치하는 경우 요청을 자동으로 무시합니다. 경우에 따라 실제 파일이 없는 경우 라우팅에서 요청을 무시하려고 할 수도 있습니다. 예를 들어 .axd 파일 이름 확장명 에 해당하는 물리적 파일이 없더라도 ASP.NET .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인 경우

예제

다음 예제에서는 이 메서드를 사용하여 .aspx 확장이 있는 모든 URL을 무시하는 방법을 보여줍니다. 확장명이 ".aspx"인 파일에 대한 모든 URL을 처리하기 위해 사용자 지정 HTTP 처리기를 등록하는 경우 이 작업을 수행할 수 있습니다. 모든 .aspx 요청과 일치하는 단일 URL 패턴에는 와 같은 {*path}.aspx/{*pathinfo}두 개의 catchall 매개 변수가 필요합니다. (이 패턴은 쿼리 문자열 매개 변수가 있는 URL을 포함하여 .aspx 끝나는 모든 URL과 일치합니다.) 그러나 라우팅은 끝에 하나의 catchall 매개 변수만 허용합니다. 또는 모든 URL과 일치하는 단일 catchall 매개 변수가 있는 URL 패턴을 지정한 다음, 다음 예제와 같이 .aspx 확장이 없는 모든 항목을 제외하는 제약 조건을 지정할 수 있습니다.

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

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

이전 코드 줄은 일반적으로 오버로드 예제와 같이 Global.asax의 Application_Start 메서드에서 호출되는 메서드에 Ignore(String) 추가됩니다.

설명

이 메서드는 경로 처리기에 매핑 StopRoutingHandler 되는 경로를 만듭니다. 이 메서드를 호출한 후에는 지정된 URL 패턴과 일치하는 요청이 경로 요청으로 처리되지 않습니다.

ASP.NET 라우팅은 URL이 이미지 파일과 같은 실제 파일과 일치하는 경우 요청을 자동으로 무시합니다. 경우에 따라 실제 파일이 없는 경우 라우팅에서 요청을 무시하려고 할 수도 있습니다. 예를 들어 .axd 파일 이름 확장명 에 해당하는 물리적 파일이 없더라도 ASP.NET .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이 이미지 파일과 같은 실제 파일과 일치하는 경우 요청을 자동으로 무시합니다. 경우에 따라 실제 파일이 없는 경우 라우팅에서 요청을 무시하려고 할 수도 있습니다. 예를 들어 .axd 파일 이름 확장명 에 해당하는 물리적 파일이 없더라도 ASP.NET .axd 파일에 대해 자동으로 만드는 요청은 경로 요청으로 처리되지 않아야 합니다.

추가 정보

적용 대상