HttpServerUtility.TransferRequest Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет асинхронное выполнение заданного URL-адреса.
Перегрузки
| TransferRequest(String) |
Выполняет асинхронное выполнение заданного URL-адреса. |
| TransferRequest(String, Boolean) |
Выполняет асинхронное выполнение заданного URL-адреса и сохраняет параметры строки запросов. |
| TransferRequest(String, Boolean, String, NameValueCollection) |
Выполняет асинхронное выполнение заданного URL-адреса с использованием указанного метода и заголовков HTTP. |
| TransferRequest(String, Boolean, String, NameValueCollection, Boolean) |
Выполняет асинхронно заданный URL-адрес, используя указанный метод HTTP, заголовки и путь, а также, при необходимости, сохраняет значения формы и удостоверение пользователя. |
Комментарии
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 -> unitPublic Sub TransferRequest (path As String)Параметры
- path
- String
URL-путь новой выполняемой страницы на сервере.
Исключения
Для запроса требуется интегрированный режим конвейера IIS 7.0.
Сервер недоступен для обработки запроса.
Параметр path имеет значение null.
Параметр path является недопустимым.
Комментарии
Эта перегрузка метода вызывает перегрузку TransferRequest с набором false``preserveForm параметров, null``method 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 -> unitPublic Sub TransferRequest (path As String, preserveForm As Boolean)Параметры
- path
- String
URL-путь новой выполняемой страницы на сервере.
- preserveForm
- Boolean
Значение true для сохранения коллекции Form; значение false для удаления коллекции Form.
Исключения
Для запроса требуется интегрированный режим конвейера IIS 7.0.
Сервер недоступен для обработки запроса.
Параметр path имеет значение null.
Параметр path является недопустимым.
Комментарии
Эта перегрузка вызывает перегрузку TransferRequest с параметромpreserveForm, заданным значением, переданным значением, headers method nullпараметром, равным параметру nullи preserveUser набору trueпараметров. Дополнительные сведения см. в разделе "Примечания" в TransferRequest(String, Boolean, String, NameValueCollection)разделе .
TransferRequestпредставлен в платформа .NET Framework версии 3.5. Дополнительные сведения см. в статье Версии и зависимости платформы .NET Framework.
Применяется к
TransferRequest(String, Boolean, String, NameValueCollection)
Выполняет асинхронное выполнение заданного URL-адреса с использованием указанного метода и заголовков HTTP.
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 -> unitPublic Sub TransferRequest (path As String, preserveForm As Boolean, method As String, headers As NameValueCollection)Параметры
- path
- String
URL-путь новой выполняемой страницы на сервере.
- preserveForm
- Boolean
Значение true для сохранения коллекции Form; значение false для удаления коллекции Form.
- 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, текущий текст сущности запроса будет доступен целевому запросу. Это позволяет передавать записи и отправки форм.Если удостоверение пользователя в настоящее время задано в исходном запросе, удостоверение будет передано в новый запрос. Это позволяет повторно использовать результаты проверки подлинности для нового запроса, прошедшие проверку подлинности. Если вы не хотите, чтобы пользователь был передан, установите его
nullв исходном запросе перед передачей.headersЕсли параметр указан, новый запрос будет выполняться с указанными заголовками. Его можно использовать для изменения заголовков запросов и файлов cookie для нового запроса или добавления специального заголовка, указывающего, где был получен исходный запрос.Этот метод вызывает перегрузку TransferRequest(String, Boolean, String, NameValueCollection, Boolean) метода с заданным параметром
true``preserveUser.
Применяется к
TransferRequest(String, Boolean, String, NameValueCollection, Boolean)
Выполняет асинхронно заданный URL-адрес, используя указанный метод HTTP, заголовки и путь, а также, при необходимости, сохраняет значения формы и удостоверение пользователя.
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 -> unitPublic Sub TransferRequest (path As String, preserveForm As Boolean, method As String, headers As NameValueCollection, preserveUser As Boolean)Параметры
- path
- String
Путь.
- preserveForm
- Boolean
Значение true для сохранения коллекции Form; значение false для удаления коллекции Form.
- method
- String
Метод HTTP, используемый в новом запросе.
- headers
- NameValueCollection
Объект NameValueCollection, содержащий заголовки запроса для нового запроса.
- preserveUser
- Boolean
Значение true для сохранения удостоверения пользователя; в противном случае — значение false. Другие перегрузки метода данного метода вызывают эту перегрузку со значением true этого параметра.
Исключения
Для запроса требуется интегрированный режим конвейера IIS 7.0.
Сервер недоступен для обработки запроса.
Параметр path имеет значение null.
Параметр path является недопустимым.
Комментарии
Дополнительные сведения см. в TransferRequest(String, Boolean, String, NameValueCollection)разделе "Примечания".