다음을 통해 공유


HttpServerUtility.TransferRequest 메서드

정의

지정된 URL의 비동기 실행을 수행합니다.

오버로드

TransferRequest(String)

지정된 URL의 비동기 실행을 수행합니다.

TransferRequest(String, Boolean)

지정된 URL의 비동기 실행을 수행하고 쿼리 문자열 매개 변수를 유지합니다.

TransferRequest(String, Boolean, String, NameValueCollection)

지정된 HTTP 메서드와 헤더를 사용하여 지정된 URL의 비동기 실행을 수행합니다.

TransferRequest(String, Boolean, String, NameValueCollection, Boolean)

지정된 HTTP 메서드, 헤더 및 경로를 사용하여 지정된 URL의 비동기 실행을 수행하며 폼 값과 사용자 ID를 선택적으로 유지합니다.

설명

TransferRequest는 .NET Framework 버전 3.5에서 도입되었습니다. .NET Framework 대한 요약 정보는 버전 및 종속성을 참조하세요.

TransferRequest(String)

지정된 URL의 비동기 실행을 수행합니다.

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

매개 변수

path
String

서버에서 실행할 새 페이지의 URL 경로입니다.

예외

요청에는 IIS 7.0의 통합 파이프라인 모드가 필요합니다.

요청 처리에 서버를 사용할 수 없습니다.

path 매개 변수가 null인 경우

path 매개 변수가 잘못되었습니다.

설명

이 메서드 오버로드는 매개 변수가 TransferRequest 설정된 false오버로드preserveForm, method 매개 변수로 설정된 null매개 변수, headers 매개 변수로 설정된 null매개 변수를 preserveUser 호출합니다true. 자세한 내용은 오버로드의 "주의" 섹션을 TransferRequest(String, Boolean, String, NameValueCollection) 참조하세요.

적용 대상

TransferRequest(String, Boolean)

지정된 URL의 비동기 실행을 수행하고 쿼리 문자열 매개 변수를 유지합니다.

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

매개 변수

path
String

서버에서 실행할 새 페이지의 URL 경로입니다.

preserveForm
Boolean

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

예외

요청에는 IIS 7.0의 통합 파이프라인 모드가 필요합니다.

요청 처리에 서버를 사용할 수 없습니다.

path 매개 변수가 null인 경우

path 매개 변수가 잘못되었습니다.

설명

이 오버로드는 매개 변수가 TransferRequest preserveForm 전달된 값으로 설정된 오버로드, method 매개 변수로 null설정된 매개 변수, headers 매개 변수로 설정된 null매개 변수 및 preserveUser 매개 변수를 호출합니다 true. 자세한 내용은 의 "주의" 섹션을 참조하세요 TransferRequest(String, Boolean, String, NameValueCollection).

TransferRequest .NET Framework 버전 3.5에서에서 도입 되었습니다. 자세한 내용은 버전 및 종속성을 참조하세요.

적용 대상

TransferRequest(String, Boolean, String, NameValueCollection)

지정된 HTTP 메서드와 헤더를 사용하여 지정된 URL의 비동기 실행을 수행합니다.

public:
 void TransferRequest(System::String ^ path, bool preserveForm, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ headers);
public void TransferRequest (string path, bool preserveForm, string method, System.Collections.Specialized.NameValueCollection headers);
member this.TransferRequest : string * bool * string * System.Collections.Specialized.NameValueCollection -> unit
Public Sub TransferRequest (path As String, preserveForm As Boolean, method As String, headers As NameValueCollection)

매개 변수

path
String

서버에서 실행할 새 페이지의 URL 경로입니다.

preserveForm
Boolean

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

method
String

새 요청을 실행하는 데 사용할 HTTP 메서드입니다.

headers
NameValueCollection

새 요청에 대한 요청 헤더의 NameValueCollection입니다.

예외

요청에는 IIS 7.0이 통합 모드에서 실행되어야 합니다.

요청 처리에 서버를 사용할 수 없습니다.

path 매개 변수가 null인 경우

path 매개 변수가 잘못되었습니다.

설명

이 메서드는 IIS 7.0에서 통합 파이프라인 모드로 실행할 때 올바른 요청 컨텍스트로 대상 요청을 실행하는 동안 요청 처리를 한 리소스 유형에서 다른 리소스 유형으로 전송할 수 있도록 하는 데 사용됩니다. 예를 들어 이 메서드를 TransferRequest 사용하여 ASPX 페이지에 대한 요청을 XML 페이지에 대한 요청으로 전송할 수 있습니다.

이 메서드는 TransferRequest 다음 조건을 사용하여 지정된 URL의 비동기 자식 실행을 수행합니다.

  • 매개 변수가 path 쿼리 문자열을 지정하는 경우 새 쿼리 문자열로 사용됩니다. 쿼리 문자열이 포함되지 않으면 요청의 쿼리 문자열이 다시 사용됩니다.

  • 매개 변수를 method 지정하면 매개 변수가 사용됩니다. null이 경우 원래 요청의 HTTP 메서드가 사용됩니다.

  • 매개 변수인 preserveForm true경우 요청의 현재 엔터티 본문을 대상 요청에 사용할 수 있습니다. 이렇게 하면 양식 게시물 및 업로드를 전송할 수 있습니다.

  • 사용자 ID가 현재 원래 요청에 설정되어 있으면 ID가 새 요청으로 전송됩니다. 이렇게 하면 인증된 요청이 새 요청에 대한 인증 결과를 다시 사용할 수 있습니다. 사용자를 전송하지 않으려면 전송하기 전에 원래 요청으로 사용자를 null 설정합니다.

  • 매개 변수를 headers 지정하면 지정된 헤더를 사용하여 새 요청이 실행됩니다. 새 요청에 대한 요청 헤더 및 쿠키를 수정하거나 원래 요청이 수신된 위치를 지정하는 특수 헤더를 추가하는 데 사용할 수 있습니다.

    이 메서드는 매개 변수가 TransferRequest(String, Boolean, String, NameValueCollection, Boolean) .로 설정된 메서드 오버로드를 preserveUser 호출합니다 true.

적용 대상

TransferRequest(String, Boolean, String, NameValueCollection, Boolean)

지정된 HTTP 메서드, 헤더 및 경로를 사용하여 지정된 URL의 비동기 실행을 수행하며 폼 값과 사용자 ID를 선택적으로 유지합니다.

public:
 void TransferRequest(System::String ^ path, bool preserveForm, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ headers, bool preserveUser);
public void TransferRequest (string path, bool preserveForm, string method, System.Collections.Specialized.NameValueCollection headers, bool preserveUser);
member this.TransferRequest : string * bool * string * System.Collections.Specialized.NameValueCollection * bool -> unit
Public Sub TransferRequest (path As String, preserveForm As Boolean, method As String, headers As NameValueCollection, preserveUser As Boolean)

매개 변수

path
String

경로입니다.

preserveForm
Boolean

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

method
String

새 요청에서 사용할 HTTP 메서드입니다.

headers
NameValueCollection

새 요청의 요청 헤더를 포함하는 NameValueCollection 개체입니다.

preserveUser
Boolean

사용자 ID를 보존하려면 true이고, 그렇지 않으면 false입니다. 이 메서드의 다른 메서드 오버로드는 이 매개 변수가 true로 설정된 이 오버로드를 호출합니다.

예외

요청에는 IIS 7.0의 통합 파이프라인 모드가 필요합니다.

요청 처리에 서버를 사용할 수 없습니다.

path 매개 변수가 null인 경우

path 매개 변수가 잘못되었습니다.

설명

자세한 내용은 의 "주의" 섹션을 참조하세요 TransferRequest(String, Boolean, String, NameValueCollection).

적용 대상