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 см. в разделе Versions and Dependencies.
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 с набором preserveForm параметровfalse, для параметра methodзадано значение , nullheaders для параметра задано 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-адрес новой страницы на сервере для выполнения.
Исключения
Для запроса требуется интегрированный режим конвейера IIS 7.0.
Сервер недоступен для обработки запроса.
Параметр path имеет значение null.
Недопустимый параметр path.
Комментарии
Эта перегрузка вызывает TransferRequest перегрузку с preserveForm параметром, заданным значением, переданным в, method параметром nullheaders, равным, параметру, в который nullзадано значение , и preserveUser набору trueпараметров. Дополнительные сведения см. в разделе "Примечания" в TransferRequest(String, Boolean, String, NameValueCollection)разделе .
TransferRequest представлен в .NET Framework версии 3.5. Дополнительные сведения см. в разделе "Версии и зависимости".
Применяется к
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-адрес новой страницы на сервере для выполнения.
- 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) метода с заданным параметром
preserveUsertrue.
Применяется к
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
Путь.
- method
- String
Метод HTTP, используемый в новом запросе.
- headers
- NameValueCollection
NameValueCollection Объект, содержащий заголовки запросов для нового запроса.
- preserveUser
- Boolean
true для сохранения удостоверения пользователя; falseв противном случае . Другие перегрузки этого метода вызывают эту перегрузку с заданным параметром true.
Исключения
Для запроса требуется интегрированный режим конвейера IIS 7.0.
Сервер недоступен для обработки запроса.
Параметр path имеет значение null.
Недопустимый параметр path.
Комментарии
Дополнительные сведения см. в разделе "Примечания" в TransferRequest(String, Boolean, String, NameValueCollection)разделе .
