HttpServerUtility.Transfer 메서드

정의

현재 페이지의 실행을 종료하고 현재 요청에 대한 새 페이지의 실행을 시작합니다.Terminates execution of the current page and starts execution of a new page for the current request.

오버로드

Transfer(String)

현재 요청에 대해 현재 페이지의 실행을 종료하고 해당 페이지의 지정된 URL 경로를 사용하여 새 페이지의 실행을 시작합니다.For the current request, terminates execution of the current page and starts execution of a new page by using the specified URL path of the page.

Transfer(String, Boolean)

현재 페이지의 실행을 종료하고 해당 페이지의 지정된 URL 경로를 사용하여 새 페이지의 실행을 시작합니다.Terminates execution of the current page and starts execution of a new page by using the specified URL path of the page. QueryStringForm 컬렉션을 지울 것인지 여부를 지정합니다.Specifies whether to clear the QueryString and Form collections.

Transfer(IHttpHandler, Boolean)

현재 페이지의 실행을 종료하고 IHttpHandler 인터페이스를 구현하고 QueryStringForm 컬렉션을 지울지 여부를 지정하는 사용자 지정 HTTP 처리기를 사용하여 새 요청의 실행을 시작합니다.Terminates execution of the current page and starts execution of a new request by using a custom HTTP handler that implements the IHttpHandler interface and specifies whether to clear the QueryString and Form collections.

Transfer(String)

현재 요청에 대해 현재 페이지의 실행을 종료하고 해당 페이지의 지정된 URL 경로를 사용하여 새 페이지의 실행을 시작합니다.For the current request, terminates execution of the current page and starts execution of a new page by using the specified URL path of the page.

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

매개 변수

path
String

서버에서 실행할 새 페이지의 URL 경로입니다.The URL path of the new page on the server to execute.

설명

전송 페이지에는 다른.aspx 페이지가 있어야 합니다.The page transferred to should be another .aspx page. 예를 들어.asp 또는.asmx 페이지로 전송 올바르지 않습니다.For instance, a transfer to an .asp or .asmx page is not valid. 합니다 Transfer 메서드 유지 합니다 QueryStringForm 컬렉션입니다.The Transfer method preserves the QueryString and Form collections.

Transfer 호출 End을 throw 하는 ThreadAbortException 완료 되 면 예외입니다.Transfer calls End, which throws a ThreadAbortException exception upon completion.

ASP.NET에서 현재 사용자에서 제공 하는 리소스를 볼 수 있는 권한이 있는지 확인 하지 않습니다는 Transfer 메서드.ASP.NET does not verify that the current user is authorized to view the resource delivered by the Transfer method. ASP.NET 인증 및 권한 부여 논리가 원래 리소스 처리기가 호출 되기 전에 실행을 ASP.NET에 나타난 처리기를 직접 호출을 Transfer 메서드 및 인증 및 권한 부여 논리 새 다시 실행 하지 않습니다 리소스입니다.Although the ASP.NET authorization and authentication logic runs before the original resource handler is called, ASP.NET directly calls the handler indicated by the Transfer method and does not rerun authentication and authorization logic for the new resource. 애플리케이션의 보안 정책 리소스에 액세스할 수 있는 적절 한 권한을 클라이언트에 필요한 경우 애플리케이션 가지도록 하거나 사용자 지정 액세스 제어 메커니즘을 제공 해야 합니다.If your application's security policy requires clients to have appropriate authorization to access the resource, the application should force reauthorization or provide a custom access-control mechanism.

사용 하 여 다시 인증을 할 수 있습니다 합니다 Redirect 메서드 대신는 Transfer 메서드.You can force reauthorization by using the Redirect method instead of the Transfer method. Redirect 메서드는 브라우저는 새 리소스를 요청 하는 클라이언트 쪽 리디렉션을 수행 합니다.The Redirect method performs a client-side redirect in which the browser requests the new resource. 이 리디렉션 시스템으로 들어가는 새 요청을 이기 때문에 인터넷 정보 서비스 (IIS) 및 ASP.NET 모두 보안 정책의 모든 인증 및 권한 부여 논리를 거쳐야 합니다.Because this redirect is a new request entering the system, it is subjected to all the authentication and authorization logic of both Internet Information Services (IIS) and ASP.NET security policy.

사용 하는 사용자 지정 권한 부여 메서드를 통합 하 여 리소스를 볼 수 있는 권한이 있는지 확인할 수 있습니다 합니다 IsInRole 애플리케이션 호출 하기 전에 메서드를 Transfer 메서드.You can verify that the user has permission to view the resource by incorporating a custom authorization method that uses the IsInRole method before the application calls the Transfer method.

Transfer(String, Boolean)

현재 페이지의 실행을 종료하고 해당 페이지의 지정된 URL 경로를 사용하여 새 페이지의 실행을 시작합니다.Terminates execution of the current page and starts execution of a new page by using the specified URL path of the page. QueryStringForm 컬렉션을 지울 것인지 여부를 지정합니다.Specifies whether to clear the QueryString and Form collections.

public:
 void Transfer(System::String ^ path, bool preserveForm);
public void Transfer (string path, bool preserveForm);
member this.Transfer : string * bool -> unit
Public Sub Transfer (path As String, preserveForm As Boolean)

매개 변수

path
String

서버에서 실행할 새 페이지의 URL 경로입니다.The URL path of the new page on the server to execute.

preserveForm
Boolean

QueryStringForm 컬렉션을 유지하려면 true이고, QueryStringForm 컬렉션을 지우려면 false입니다.true to preserve the QueryString and Form collections; false to clear the QueryString and Form collections.

예외

현재 페이지 요청이 콜백인 경우The current page request is a callback.

예제

다음 예에서는 현재 페이지와 같은 디렉터리에 새 페이지를 실행 합니다.The following example executes a new page in the same directory as the current page.

Server.Transfer("Logon.aspx", true);

Server.Transfer("Logon.aspx", true)

설명

전송 페이지에는 다른.aspx 페이지가 있어야 합니다.The page transferred to should be another .aspx page. 예를 들어.asp 또는.asmx 페이지로 전송 올바르지 않습니다.For instance, a transfer to an .asp or .asmx page is not valid.

Transfer 호출 End을 throw 하는 ThreadAbortException 완료 되 면 예외입니다.Transfer calls End, which throws a ThreadAbortException exception upon completion.

설정 하는 경우는 preserveForm 매개 변수를 true, 대상 페이지를 사용 하 여 이전 페이지의 뷰 상태에 액세스할 수는 PreviousPage 속성입니다.If you set the preserveForm parameter to true, the target page will be able to access the view state of the previous page by using the PreviousPage property.

보안상의 이유로 유지 해야 합니다 enableViewStateMac 특성이 설정 true합니다.For security purposes, you should keep the enableViewStateMac attribute set to true. ASP.NET에서 현재 사용자에서 제공 하는 리소스를 볼 수 있는 권한이 있는지 확인 하지 않습니다는 Transfer 메서드.ASP.NET does not verify that the current user is authorized to view the resource delivered by the Transfer method. ASP.NET 인증 및 권한 부여 논리가 원래 리소스 처리기가 호출 되기 전에 실행을 ASP.NET에 나타난 처리기를 직접 호출을 Transfer 메서드 및 인증 및 권한 부여 논리 새 다시 실행 하지 않습니다 리소스입니다.Although the ASP.NET authorization and authentication logic runs before the original resource handler is called, ASP.NET directly calls the handler indicated by the Transfer method and does not rerun authentication and authorization logic for the new resource. 애플리케이션의 보안 정책 리소스에 액세스할 수 있는 적절 한 권한을 클라이언트에 필요한 경우 애플리케이션 가지도록 하거나 사용자 지정 액세스 제어 메커니즘을 제공 해야 합니다.If your application's security policy requires clients to have appropriate authorization to access the resource, the application should force reauthorization or provide a custom access-control mechanism.

사용 하 여 다시 인증을 할 수 있습니다 합니다 Redirect 메서드 대신는 Transfer 메서드.You can force reauthorization by using the Redirect method instead of the Transfer method. Redirect 메서드는 브라우저는 새 리소스를 요청 하는 클라이언트 쪽 리디렉션을 수행 합니다.The Redirect method performs a client-side redirect in which the browser requests the new resource. 이 리디렉션 시스템으로 들어가는 새 요청을 이기 때문에 인터넷 정보 서비스 (IIS) 및 ASP.NET 모두 보안 정책의 모든 인증 및 권한 부여 논리를 거쳐야 합니다.Because this redirect is a new request entering the system, it is subjected to all the authentication and authorization logic of both Internet Information Services (IIS) and ASP.NET security policy.

사용 하는 사용자 지정 권한 부여 메서드를 통합 하 여 리소스를 볼 수 있는 권한이 있는지 확인할 수 있습니다 합니다 IsInRole 애플리케이션 호출 하기 전에 메서드를 Transfer 메서드.You can verify that the user has permission to view the resource by incorporating a custom authorization method that uses the IsInRole method before the application calls the Transfer method.

Transfer(IHttpHandler, Boolean)

현재 페이지의 실행을 종료하고 IHttpHandler 인터페이스를 구현하고 QueryStringForm 컬렉션을 지울지 여부를 지정하는 사용자 지정 HTTP 처리기를 사용하여 새 요청의 실행을 시작합니다.Terminates execution of the current page and starts execution of a new request by using a custom HTTP handler that implements the IHttpHandler interface and specifies whether to clear the QueryString and Form collections.

public:
 void Transfer(System::Web::IHttpHandler ^ handler, bool preserveForm);
public void Transfer (System.Web.IHttpHandler handler, bool preserveForm);
member this.Transfer : System.Web.IHttpHandler * bool -> unit
Public Sub Transfer (handler As IHttpHandler, preserveForm As Boolean)

매개 변수

handler
IHttpHandler

현재 요청을 전송할 IHttpHandler를 구현하는 HTTP 처리기입니다.The HTTP handler that implements the IHttpHandler to transfer the current request to.

preserveForm
Boolean

QueryStringForm 컬렉션을 유지하려면 true이고, QueryStringForm 컬렉션을 지우려면 false입니다.true to preserve the QueryString and Form collections; false to clear the QueryString and Form collections.

예외

현재 페이지 요청이 콜백인 경우The current page request is a callback.

설명

Cls는 공용 언어 사양 ()는 모든 언어로 HTTP 요청의 특정 한 미리 정의 된 형식을 처리 하려면 사용자 지정 HTTP 처리기를 작성할 수 있습니다.You can write custom HTTP handlers to process specific, predefined types of HTTP requests in any language that is compliant with the Common Language Specification (CLS). 기존 ASP (라고도: 클래식 ASP) 페이지 또는 ASP.NET 페이지 대신 HTTP 처리기 클래스에 정의 된 실행 코드에서 이러한 특정 요청에 응답 합니다.Executable code that is defined in the HTTP handler classes instead of conventional ASP (also known as classic ASP) pages or ASP.NET pages responds to these specific requests. 다르지만 유사한 기능을 제공 하 고 HTTP 처리기 저수준 요청 및 응답 서비스 웹 서버의 인터넷 정보 서비스 (IIS)를 실행 하는 상호 작용할 수 있도록 더 간단한 프로그래밍 모델을 사용 하면서 ISAPI 확장 합니다.HTTP handlers allow for interacting with the low-level request and response services of a Web server that is running Internet Information Services (IIS), and they provide functionality that is similar to ISAPI extensions but with a simpler programming model.

설정 하는 경우는 preserveForm 매개 변수를 true, 대상 페이지를 사용 하 여 이전 페이지의 뷰 상태에 액세스할 수는 PreviousPage 속성입니다.If you set the preserveForm parameter to true, the target page will be able to access the view state of the previous page by using the PreviousPage property.

보안상의 이유로 유지 해야 합니다 enableViewStateMac 특성이 설정 true합니다.For security purposes, you should keep the enableViewStateMac attribute set to true. ASP.NET에서 현재 사용자에서 제공 하는 리소스를 볼 수 있는 권한이 있는지 확인 하지 않습니다는 Transfer 메서드.ASP.NET does not verify that the current user is authorized to view the resource delivered by the Transfer method. ASP.NET에 나타난 처리기를 직접 호출 ASP.NET 인증 및 권한 부여 논리가 원래 리소스 처리기가 호출 되기 전에 실행을 Transfer 메서드와 새 인증 및 권한 부여 논리를 다시 실행 하지 않습니다 리소스입니다.Although the ASP.NET authorization and authentication logic runs before the original resource handler is called, ASP.NET directly calls the handler indicated by the Transfer method, and does not rerun authentication and authorization logic for the new resource. 애플리케이션에 대 한 보안 정책 리소스에 액세스할 수 있는 적절 한 권한을 클라이언트에 필요한 경우 애플리케이션 가지도록 하거나 사용자 지정 액세스 제어 메커니즘을 제공 해야 합니다.If the security policy for your application requires clients to have appropriate authorization to access the resource, the application should force reauthorization or provide a custom access-control mechanism.

사용 하 여 다시 인증을 할 수 있습니다 합니다 Redirect 메서드 대신는 Transfer 메서드.You can force reauthorization by using the Redirect method instead of the Transfer method. Redirect 메서드는 브라우저는 새 리소스를 요청 하는 클라이언트 쪽 리디렉션을 수행 합니다.The Redirect method performs a client-side redirect in which the browser requests the new resource. 이 리디렉션 시스템으로 들어가는 새 요청을 이기 때문에 IIS 및 ASP.NET 모두 보안 정책의 모든 인증 및 권한 부여 논리를 거쳐야 합니다.Because this redirect is a new request entering the system, it is subjected to all the authentication and authorization logic of both the IIS and ASP.NET security policy.

사용 하는 사용자 지정 권한 부여 메서드를 통합 하 여 리소스를 볼 수 있는 권한이 있는지 확인할 수 있습니다 합니다 IsInRole 애플리케이션 호출 하기 전에 메서드를 Transfer 메서드.You can verify that the user has permission to view the resource by incorporating a custom authorization method that uses the IsInRole method before the application calls the Transfer method.

적용 대상