HttpServerUtility.TransferRequest Метод

Определение

Выполняет асинхронное выполнение заданного URL-адреса.Performs an asynchronous execution of the specified URL.

Перегрузки

TransferRequest(String)

Выполняет асинхронное выполнение заданного URL-адреса.Performs an asynchronous execution of the specified URL.

TransferRequest(String, Boolean)

Выполняет асинхронное выполнение заданного URL-адреса и сохраняет параметры строки запросов.Performs an asynchronous execution of the specified URL and preserves query string parameters.

TransferRequest(String, Boolean, String, NameValueCollection)

Выполняет асинхронное выполнение заданного URL-адреса с использованием указанного метода и заголовков HTTP.Performs an asynchronous execution of the specified URL using the specified HTTP method and headers.

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

Выполняет асинхронно заданный url-адрес, используя указанный метод HTTP, заголовки и путь, а также, при необходимости, сохраняет значения формы и удостоверение пользователя.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)

Выполняет асинхронное выполнение заданного 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

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 с method параметром false, null headers для которого задано значение, параметру, для которого задано значение, и preserveUser null для 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)

Выполняет асинхронное выполнение заданного 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

URL-путь новой выполняемой страницы на сервере.The URL path of the new page on the server to execute.

preserveForm
Boolean

Значение true для сохранения коллекции Form; значение false для удаления коллекции Form.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, nullпараметру, headers параметру, заданию, 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. Дополнительные сведения см. в статье Версии и зависимости платформы .NET Framework.For more information, see Versions and Dependencies.

TransferRequest(String, Boolean, String, NameValueCollection)

Выполняет асинхронное выполнение заданного URL-адреса с использованием указанного метода и заголовков HTTP.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

URL-путь новой выполняемой страницы на сервере.The URL path of the new page on the server to execute.

preserveForm
Boolean

Значение true для сохранения коллекции Form; значение false для удаления коллекции Form.true to preserve the Form collection; false to clear the Form collection.

method
String

Метод HTTP для использования при выполнении нового запроса.The HTTP method to use in the execution of the new request.

headers
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 метод для перемещения запроса страницы ASPX на запрос XML-страницы.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.

  • Если параметр имеет значение true, текущий текст сущности запроса будет доступен для целевого запроса. preserveFormIf 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.

  • Если в данный момент в исходном запросе задано удостоверение пользователя, удостоверение будет передано в новый запрос.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. Это можно использовать для изменения заголовков запроса и файлов cookie для нового запроса или добавления специального заголовка, указывающего, где был получен исходный запрос.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) перегрузку метода с параметром, trueдля которого preserveUser задано значение.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)

Выполняет асинхронно заданный url-адрес, используя указанный метод HTTP, заголовки и путь, а также, при необходимости, сохраняет значения формы и удостоверение пользователя.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

Путь.The path.

preserveForm
Boolean

Значение true для сохранения коллекции Form; значение false для удаления коллекции Form.true to preserve the Form collection; false to clear the Form collection.

method
String

Метод HTTP, используемый в новом запросе.The HTTP method to use in the new request.

headers
NameValueCollection

Объект NameValueCollection, содержащий заголовки запроса для нового запроса.A NameValueCollection object that contains request headers for the new request.

preserveUser
Boolean

Значение 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).

Применяется к