HttpServerUtility.Execute 메서드

참조

정의

네임스페이스:: System.Web

어셈블리:: System.Web.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

현재 요청의 컨텍스트에서 지정된 리소스에 대한 처리기를 실행하고 요청을 호출한 페이지로 실행 제어를 반환합니다.

오버로드

Execute(String)	현재 요청의 컨텍스트에서 지정된 가상 경로에 대한 처리기를 실행합니다.
Execute(String, Boolean)	현재 요청의 컨텍스트에서 지정된 가상 경로에 대한 처리기를 실행하고 QueryString 및 Form 컬렉션을 지울지 여부를 지정합니다.
Execute(String, TextWriter)	현재 요청의 컨텍스트에서 지정된 가상 경로에 대한 처리기를 실행합니다. TextWriter는 실행된 처리기에서 출력을 캡처합니다.
Execute(String, TextWriter, Boolean)	현재 요청의 컨텍스트에서 지정된 가상 경로에 대한 처리기를 실행합니다. TextWriter는 페이지에서 출력을 캡처하며 부울 매개 변수는 QueryString 및 Form 컬렉션을 지울지 여부를 지정합니다.
Execute(IHttpHandler, TextWriter, Boolean)	현재 요청의 컨텍스트에서 지정된 가상 경로에 대한 처리기를 실행합니다. TextWriter는 실행된 처리기에서 출력을 캡처하며 부울 매개 변수는 QueryString 및 Form 컬렉션을 지울지 여부를 지정합니다.

Execute(String)

현재 요청의 컨텍스트에서 지정된 가상 경로에 대한 처리기를 실행합니다.

public:
 void Execute(System::String ^ path);

public void Execute (string path);

member this.Execute : string -> unit

Public Sub Execute (path As String)

매개 변수

path: String

실행할 URL 경로입니다.

예외

HttpException

현재 HttpContext 가 null인 경우

또는 path에 지정된 처리기를 실행하는 동안 오류가 발생한 경우

ArgumentNullException

path이(가) null인 경우

또는 path 가 가상 경로가 아닙니다.

예제

다음은 현재 디렉터리에 .aspx 페이지 "Updateinfo.aspx"를 표시하는 예제입니다. Updateinfo.aspx 페이지가 표시된 후 프로그램 실행이 시작 페이지로 돌아갑니다.

Server.Execute("updateinfo.aspx");

Server.Execute("updateinfo.aspx")

설명

메서드는 Execute 새 페이지의 실행이 완료된 후 원래 페이지의 실행을 계속합니다. 메서드는 Transfer 다른 처리기로 실행을 무조건 전송합니다.

ASP.NET 현재 사용자가 메서드에 의해 Execute 전달된 리소스를 볼 권한이 있는지 확인하지 않습니다. ASP.NET 권한 부여 및 인증 논리는 원래 리소스 처리기가 호출되기 전에 실행되지만 ASP.NET 메서드에 표시된 처리기를 직접 호출하고 새 리소스에 Execute 대한 인증 및 권한 부여 논리를 다시 실행하지 않습니다. 애플리케이션의 보안 정책 리소스에 액세스할 수 있는 적절 한 권한을 클라이언트에 필요한 경우 애플리케이션 가지도록 하거나 사용자 지정 액세스 제어 메커니즘을 제공 해야 합니다.

메서드 대신 메서드를 사용하여 다시 인증을 Redirect 강제 적용할 Execute 수 있습니다. Redirect 는 브라우저에서 새 리소스를 요청하는 클라이언트 쪽 리디렉션을 수행합니다. 이 리디렉션은 시스템에 들어오는 새 요청이므로 IIS(인터넷 정보 서비스) 및 ASP.NET 보안 정책의 모든 인증 및 권한 부여 논리가 적용됩니다.

사용 하는 사용자 지정 권한 부여 메서드를 통합 하 여 리소스를 볼 수 있는 권한이 있는지 확인할 수 있습니다 합니다 IsInRole 애플리케이션 호출 하기 전에 메서드를 Execute 메서드.

적용 대상

Execute(String, Boolean)

현재 요청의 컨텍스트에서 지정된 가상 경로에 대한 처리기를 실행하고 QueryString 및 Form 컬렉션을 지울지 여부를 지정합니다.

public:
 void Execute(System::String ^ path, bool preserveForm);

public void Execute (string path, bool preserveForm);

member this.Execute : string * bool -> unit

Public Sub Execute (path As String, preserveForm As Boolean)

매개 변수

path: String

실행할 URL 경로입니다.

preserveForm: Boolean

true 및 QueryString 컬렉션을 유지하려면 Form 이고, false 및 QueryString 컬렉션을 지우려면 Form 입니다.

예외

HttpException

현재 HttpContext 가 null인 경우

또는 path에 지정된 처리기를 실행하는 동안 오류가 발생한 경우

ArgumentNullException

path이(가) null인 경우

또는 path 가 가상 경로가 아닙니다.

예제

다음 예제에서는 현재 요청에서 .aspx 페이지를 Updateinfo.aspx 실행 하 고 및 Form 컬렉션을 유지 하는 QueryString 방법을 보여 줍니다. 프로그램 실행이 표시된 후 Updateinfo.aspx 시작 페이지로 돌아갑니다.

private void Page_Load(Object sender, EventArgs e)
{
    Server.Execute("updateinfo.aspx", true);
}

Sub Page_Load(ByVal Sender As Object, ByVal e As EventArgs)
    Server.Execute("updateinfo.aspx", True)
End Sub

추가 정보

Transfer

적용 대상

Execute(String, TextWriter)

현재 요청의 컨텍스트에서 지정된 가상 경로에 대한 처리기를 실행합니다. TextWriter는 실행된 처리기에서 출력을 캡처합니다.

public:
 void Execute(System::String ^ path, System::IO::TextWriter ^ writer);

public void Execute (string path, System.IO.TextWriter writer);

member this.Execute : string * System.IO.TextWriter -> unit

Public Sub Execute (path As String, writer As TextWriter)

매개 변수

path: String

실행할 URL 경로입니다.

writer: TextWriter

출력을 캡처할 TextWriter입니다.

예외

HttpException

현재 HttpContext 가 null인 경우

또는 path에 지정된 처리기를 실행하는 동안 오류가 발생한 경우

ArgumentNullException

path이(가) null인 경우

또는 path 가 가상 경로가 아닙니다.

예제

다음 예제에서는 현재 디렉터리의 서버에서 페이지를 실행하고 Login.aspx 개체writer를 통해 페이지에서 출력을 StringWriter 수신합니다. 수신 writer 된 HTML 스트림을 HTTP 출력 스트림에 씁니다.

StringWriter writer = new StringWriter();
Server.Execute("Login.aspx", writer);
Response.Write("<H3>Please Login:</H3><br>"+ writer.ToString());

Dim writer As New StringWriter
Server.Execute("Login.aspx", writer)
Response.Write("<H3>Please Login:</H3><br>" & writer.ToString())

설명

Execute 지정된 가상 경로의 실행이 완료된 후 메서드는 원래 요청의 실행을 계속합니다. 메서드는 Transfer 다른 처리기로 실행을 무조건 전송합니다.

추가 정보

Transfer

적용 대상

Execute(String, TextWriter, Boolean)

현재 요청의 컨텍스트에서 지정된 가상 경로에 대한 처리기를 실행합니다. TextWriter는 페이지에서 출력을 캡처하며 부울 매개 변수는 QueryString 및 Form 컬렉션을 지울지 여부를 지정합니다.

public:
 void Execute(System::String ^ path, System::IO::TextWriter ^ writer, bool preserveForm);

public void Execute (string path, System.IO.TextWriter writer, bool preserveForm);

member this.Execute : string * System.IO.TextWriter * bool -> unit

Public Sub Execute (path As String, writer As TextWriter, preserveForm As Boolean)

매개 변수

path: String

실행할 URL 경로입니다.

writer: TextWriter

출력을 캡처할 TextWriter입니다.

preserveForm: Boolean

true 및 QueryString 컬렉션을 유지하려면 Form 이고, false 및 QueryString 컬렉션을 지우려면 Form 입니다.

예외

HttpException

현재 HttpContext가 Null 참조(Visual Basic에서는 Nothing)인 경우

또는 path 는 마침표(.)로 끝납니다.

또는 path에 지정된 처리기를 실행하는 동안 오류가 발생한 경우

ArgumentNullException

path이(가) null인 경우

ArgumentException

path 가 가상 경로가 아닙니다.

예제

다음 예제에서는 현재 디렉터리의 서버에서 페이지를 실행하고 Login.aspx 개체writer를 통해 페이지에서 출력을 StringWriter 수신합니다. 수신 writer 된 HTML 스트림을 HTTP 출력 스트림에 씁니다. 및 QueryString 컬렉션의 Form 내용이 유지됩니다.

private void Page_Load(Object sender, EventArgs e)
{
    System.IO.StringWriter writer = new System.IO.StringWriter();
    Server.Execute("Login.aspx", writer, true);
    Response.Write("<h3>Please Login:</h3><br />" + writer.ToString());
}

Sub Page_Load(ByVal Sender As Object, ByVal e As EventArgs)
    Dim writer As System.IO.StringWriter = New System.IO.StringWriter()
    Server.Execute("Login.aspx", writer, True)
    Response.Write("<h3>Please Login:</h3><br />" + writer.ToString())
End Sub

설명

Execute 지정된 가상 경로의 실행이 완료된 후 메서드는 원래 요청의 실행을 계속합니다. 메서드는 Transfer 다른 처리기로 실행을 무조건 전송합니다.

추가 정보

Transfer

적용 대상

Execute(IHttpHandler, TextWriter, Boolean)

현재 요청의 컨텍스트에서 지정된 가상 경로에 대한 처리기를 실행합니다. TextWriter는 실행된 처리기에서 출력을 캡처하며 부울 매개 변수는 QueryString 및 Form 컬렉션을 지울지 여부를 지정합니다.

public:
 void Execute(System::Web::IHttpHandler ^ handler, System::IO::TextWriter ^ writer, bool preserveForm);

public void Execute (System.Web.IHttpHandler handler, System.IO.TextWriter writer, bool preserveForm);

member this.Execute : System.Web.IHttpHandler * System.IO.TextWriter * bool -> unit

Public Sub Execute (handler As IHttpHandler, writer As TextWriter, preserveForm As Boolean)

매개 변수

handler: IHttpHandler

현재 요청을 전송할 IHttpHandler를 구현하는 HTTP 처리기입니다.

writer: TextWriter

출력을 캡처할 TextWriter입니다.

preserveForm: Boolean

true 및 QueryString 컬렉션을 유지하려면 Form 이고, false 및 QueryString 컬렉션을 지우려면 Form 입니다.

예외

HttpException

handler에 지정된 처리기를 실행하는 동안 오류가 발생한 경우

ArgumentNullException

handler 매개 변수가 null인 경우

설명

CLS(공용 언어 사양)를 준수하는 모든 언어에서 미리 정의된 특정 형식의 HTTP 요청을 처리하는 사용자 지정 HTTP 처리기를 작성할 수 있습니다. 기존 ASP(클래식 ASP라고도 함) 페이지 또는 ASP.NET 페이지 대신 HTTP 처리기 클래스에 정의된 실행 파일 코드는 이러한 특정 요청에 응답합니다. HTTP 처리기를 사용하면 IIS(인터넷 정보 서비스)를 실행하는 웹 서버의 하위 수준 요청 및 응답 서비스와 상호 작용할 수 있으며 ISAPI 확장과 비슷하지만 더 간단한 프로그래밍 모델을 사용하는 기능을 제공합니다.

ASP.NET 현재 사용자가 메서드에서 제공하는 Execute 리소스를 볼 수 있는 권한이 있는지 확인하지 않습니다. ASP.NET 권한 부여 및 인증 논리는 원래 리소스 처리기가 호출되기 전에 실행되지만 ASP.NET 메서드에 표시된 처리기를 직접 호출하고 새 리소스에 Execute 대한 인증 및 권한 부여 논리를 다시 실행하지 않습니다. 애플리케이션에 대 한 보안 정책 리소스에 액세스할 수 있는 적절 한 권한을 클라이언트에 필요한 경우 애플리케이션 가지도록 하거나 사용자 지정 액세스 제어 메커니즘을 제공 해야 합니다.

메서드 대신 메서드를 Redirect 사용하여 강제로 재인증할 Execute 수 있습니다. 브라우저 Redirect 에서 새 리소스를 요청하는 클라이언트 쪽 리디렉션을 수행합니다. 이 리디렉션은 시스템에 들어오는 새 요청이므로 IIS 및 ASP.NET 보안 정책 모두의 모든 인증 및 권한 부여 논리가 적용됩니다.

추가 정보

Transfer

적용 대상

HttpServerUtility.Execute 메서드

정의

오버로드

Execute(String)

매개 변수

예외

예제

설명

적용 대상

Execute(String, Boolean)

매개 변수

예외

예제

추가 정보

적용 대상

Execute(String, TextWriter)

매개 변수

예외

예제

설명

추가 정보

적용 대상

Execute(String, TextWriter, Boolean)

매개 변수

예외

예제

설명

추가 정보

적용 대상

Execute(IHttpHandler, TextWriter, Boolean)

매개 변수

예외

설명

추가 정보

적용 대상

추가 리소스