HttpServerUtility.TransferRequest HttpServerUtility.TransferRequest HttpServerUtility.TransferRequest HttpServerUtility.TransferRequest Method

정의

지정된 URL의 비동기 실행을 수행합니다.Performs an asynchronous execution of the specified URL.

오버로드

TransferRequest(String) TransferRequest(String) TransferRequest(String) TransferRequest(String)

지정된 URL의 비동기 실행을 수행합니다.Performs an asynchronous execution of the specified URL.

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

지정된 URL의 비동기 실행을 수행하고 쿼리 문자열 매개 변수를 유지합니다.Performs an asynchronous execution of the specified URL and preserves query string parameters.

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

지정된 HTTP 메서드와 헤더를 사용하여 지정된 URL의 비동기 실행을 수행합니다.Performs an asynchronous execution of the specified URL using the specified HTTP method and headers.

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

지정된 HTTP 메서드, 헤더 및 경로를 사용하여 지정된 URL의 비동기 실행을 수행하며 폼 값과 사용자 ID를 선택적으로 유지합니다.Performs an asynchronous execution of the specified URL using the specified HTTP method, headers, and path, and optionally preserves form values and the user identity.

설명

TransferRequest .NET Framework 버전 3.5에서에서 도입 되었습니다.TransferRequest was introduced in the .NET Framework version 3.5. .NET Framework에 대 한 요약 정보를 참조 하세요 버전 및 종속성합니다.For summary information about the .NET Framework, see Versions and Dependencies.

TransferRequest(String) TransferRequest(String) TransferRequest(String) TransferRequest(String)

지정된 URL의 비동기 실행을 수행합니다.Performs an asynchronous execution of the specified 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 String String String

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

예외

요청에 IIS 7.0IIS 7.0의 통합 파이프라인 모드가 필요한 경우The request requires the integrated pipeline mode of IIS 7.0IIS 7.0.

요청을 처리하는 데 서버를 사용할 수 없는 경우The server is not available to handle the request.

path 매개 변수가 null인 경우The path parameter is null.

path 매개 변수가 잘못되었습니다.The path parameter is invalid.

설명

이 메서드 오버 로드를 호출 합니다 TransferRequest 오버 로드를 preserveForm 매개 변수 설정 false, method 매개 변수 설정 nullheaders 매개 변수 설정 null, 및 preserveUser 매개 변수 설정 true합니다.This method overload calls the TransferRequest overload with the preserveForm parameter set to false, the method parameter set to null, the headers parameter set to null, and the preserveUser parameter set to true. 자세한 내용은의 "주의" 섹션을 참조 하세요. TransferRequest(String, Boolean, String, NameValueCollection) 오버 로드 합니다.For more information, see the "Remarks" section in TransferRequest(String, Boolean, String, NameValueCollection) overload.

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

지정된 URL의 비동기 실행을 수행하고 쿼리 문자열 매개 변수를 유지합니다.Performs an asynchronous execution of the specified URL and preserves query string parameters.

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 String String String

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

preserveForm
Boolean Boolean Boolean Boolean

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

예외

요청에 IIS 7.0IIS 7.0의 통합 파이프라인 모드가 필요한 경우The request requires the integrated pipeline mode of IIS 7.0IIS 7.0.

요청을 처리하는 데 서버를 사용할 수 없는 경우The server is not available to handle the request.

path 매개 변수가 null인 경우The path parameter is null.

path 매개 변수가 잘못되었습니다.The path parameter is invalid.

설명

이 오버 로드를 호출 합니다 TransferRequest 오버 로드는 preserveForm 매개 변수에서 전달 된 값으로 설정 합니다 method 매개 변수 설정 null, headers 매개 변수 설정 null, 및 preserveUser 매개 변수 집합 true입니다.This overload calls the TransferRequest overload with the preserveForm parameter set to the value passed in, the method parameter set to null, the headers parameter set to null, and the preserveUser parameter set to true. 자세한 내용은의 "주의" 섹션을 참조 하세요. TransferRequest(String, Boolean, String, NameValueCollection)합니다.For more information, see the "Remarks" section in TransferRequest(String, Boolean, String, NameValueCollection).

TransferRequest .NET Framework 버전 3.5에서에서 도입 되었습니다.TransferRequest is introduced in the .NET Framework version 3.5. 자세한 내용은 버전 및 종속성을 참조하세요.For more information, see Versions and Dependencies.

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

지정된 HTTP 메서드와 헤더를 사용하여 지정된 URL의 비동기 실행을 수행합니다.Performs an asynchronous execution of the specified URL using the specified HTTP method and headers.

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 String String String

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

preserveForm
Boolean Boolean Boolean Boolean

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

method
String String String String

새 요청을 실행하는 데 사용할 HTTP 메서드입니다.The HTTP method to use in the execution of the new request.

headers
NameValueCollection NameValueCollection NameValueCollection NameValueCollection

새 요청에 대한 요청 헤더의 NameValueCollection입니다.A NameValueCollection of request headers for the new request.

예외

요청에 통합 모드로 실행되는 IIS 7.0IIS 7.0이 필요한 경우The request requires IIS 7.0IIS 7.0 running in integrated mode.

요청을 처리하는 데 서버를 사용할 수 없는 경우The server is not available to handle the request.

path 매개 변수가 null인 경우The path parameter is null.

path 매개 변수가 잘못되었습니다.The path parameter is invalid.

설명

통합된 파이프라인 모드에서 실행 되는 경우이 메서드는 IIS 7.0IIS 7.0 요청을 처리 한 리소스 종류에서 올바른 요청 컨텍스트를 사용 하 여 대상 요청을 실행 하는 동안 다른 전송 될 수 있도록 합니다.This method is used when running with the integrated pipeline mode in IIS 7.0IIS 7.0 to allow request processing to be transferred from one resource type to another while executing the target request with the correct request context. 예를 들어 사용할 수 있습니다는 TransferRequest XML 페이지 요청에 ASPX 페이지에 대 한 요청을 전송 하는 방법입니다.For example, you can use the TransferRequest method to transfer a request for an ASPX page to a request for an XML page.

TransferRequest 메서드는 다음 조건에 따라 지정된 된 URL의 비동기 자식 실행을 수행 합니다.The TransferRequest method performs an asynchronous child execution of the specified URL with the following conditions:

  • 경우는 path 쿼리 문자열을 지정 하는 매개 변수, 새 쿼리 문자열로 사용 됩니다.If the path parameter specifies a query string, it will be used as the new query string. 쿼리 문자열이 포함 된 경우 요청의 쿼리 문자열 다시 사용 됩니다.If no query string is included, the query string of the request will be re-used.

  • 경우는 method 사용, 매개 변수를 지정 합니다.If the method parameter is specified, it will be used. 있으면 null, 원래 요청의 HTTP 메서드가 사용 됩니다.If it is null, the HTTP method of the original request will be used.

  • 경우는 preserveForm 매개 변수는 true, 현재 엔터티 본문 요청의 대상 요청에 제공 됩니다.If the preserveForm parameter is true, the current entity body of the request will be available to the target request. 이 폼 게시를 허용 하며 업로드를 전송할 수 있습니다.This allows form posts and uploads to be transferred.

  • 사용자 id는 원래 요청에 현재 설정 되어, id 새 요청에 전송 됩니다.If the user identity is currently set on the original request, the identity will be transferred to the new request. 이 새 요청에 대 한 인증 결과 다시 사용 하도록 인증 된 요청만 허용 합니다.This allows authenticated requests to re-use the result of the authentication for the new request. 사용자를 전송 하지 않으려면 사용자로 설정 null 전송 하기 전에 원래 요청에서.If you do not want the user to be transferred, set the user to null on the original request before transferring.

  • 경우는 headers 매개 변수가 지정 된, 지정 된 헤더를 사용 하 여 새 요청이 실행 됩니다.If the headers parameter is specified, the new request will execute with the specified headers. 이 요청 헤더 및 쿠키 새 요청에 대 한 수정에 사용할 수 있습니다 하거나 원래 요청이 수신 위치를 지정 하는 특수 헤더를 추가 합니다.This can be used to modify the request headers and cookies for the new request, or add a special header that specifies where the original request was received.

    이 메서드를 호출 합니다 TransferRequest(String, Boolean, String, NameValueCollection, Boolean) 메서드 오버 로드는 preserveUser 매개 변수 설정 true합니다.This method calls the TransferRequest(String, Boolean, String, NameValueCollection, Boolean) method overload with the preserveUser parameter set to true.

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

지정된 HTTP 메서드, 헤더 및 경로를 사용하여 지정된 URL의 비동기 실행을 수행하며 폼 값과 사용자 ID를 선택적으로 유지합니다.Performs an asynchronous execution of the specified URL using the specified HTTP method, headers, and path, and optionally preserves form values and the user identity.

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 String String String

경로입니다.The path.

preserveForm
Boolean Boolean Boolean Boolean

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

method
String String String String

새 요청에서 사용할 HTTP 메서드입니다.The HTTP method to use in the new request.

headers
NameValueCollection NameValueCollection NameValueCollection NameValueCollection

새 요청의 요청 헤더를 포함하는 NameValueCollection 개체입니다.A NameValueCollection object that contains request headers for the new request.

preserveUser
Boolean Boolean Boolean Boolean

사용자 ID를 보존하려면 true이고, 그렇지 않으면 false입니다.true to preserve the user identity; otherwise, false. 이 메서드의 다른 메서드 오버로드는 이 매개 변수가 true로 설정된 이 오버로드를 호출합니다.The other method overloads of this method call this overload with this parameter set to true.

예외

요청에 IIS 7.0IIS 7.0의 통합 파이프라인 모드가 필요한 경우The request requires the integrated pipeline mode of IIS 7.0IIS 7.0.

요청을 처리하는 데 서버를 사용할 수 없는 경우The server is not available to handle the request.

path 매개 변수가 null인 경우The path parameter is null.

path 매개 변수가 잘못되었습니다.The path parameter is invalid.

설명

자세한 내용은의 "주의" 섹션을 참조 하세요. TransferRequest(String, Boolean, String, NameValueCollection)합니다.For more information, see the "Remarks" section in TransferRequest(String, Boolean, String, NameValueCollection).

적용 대상