HttpServerUtility.TransferRequest Metode

Definisi

Ruang nama:: System.Web

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Melakukan eksekusi asinkron dari URL yang ditentukan.

Overload

Nama	Deskripsi
TransferRequest(String)	Melakukan eksekusi asinkron dari URL yang ditentukan.
TransferRequest(String, Boolean)	Melakukan eksekusi asinkron dari URL yang ditentukan dan mempertahankan parameter string kueri.
TransferRequest(String, Boolean, String, NameValueCollection)	Melakukan eksekusi asinkron DARI URL yang ditentukan menggunakan metode dan header HTTP yang ditentukan.
TransferRequest(String, Boolean, String, NameValueCollection, Boolean)	Melakukan eksekusi asinkron dari URL yang ditentukan menggunakan metode HTTP, header, dan jalur yang ditentukan, dan secara opsional mempertahankan nilai formulir dan identitas pengguna.

Keterangan

TransferRequest diperkenalkan dalam .NET Framework versi 3.5. Untuk informasi ringkasan tentang .NET Framework, lihat Versi dan Dependensi.

TransferRequest(String)

Melakukan eksekusi asinkron dari URL yang ditentukan.

public:
 void TransferRequest(System::String ^ path);

public void TransferRequest(string path);

member this.TransferRequest : string -> unit

Public Sub TransferRequest (path As String)

Parameter

path: String

Jalur URL halaman baru di server yang akan dijalankan.

Pengecualian

PlatformNotSupportedException

Permintaan ini memerlukan mode alur terintegrasi IIS 7.0.

HttpException

Server tidak tersedia untuk menangani permintaan.

ArgumentNullException

Parameternya path adalah null.

ArgumentException

Parameter path tidak valid.

Keterangan

Metode ini kelebihan beban memanggil TransferRequest kelebihan beban dengan parameter yang preserveForm diatur ke false, parameter diatur method ke null, headers parameter diatur ke null, dan preserveUser parameter diatur ke true. Untuk informasi selengkapnya, lihat bagian "Komentar" dalam TransferRequest(String, Boolean, String, NameValueCollection) kelebihan beban.

Berlaku untuk

TransferRequest(String, Boolean)

Melakukan eksekusi asinkron dari URL yang ditentukan dan mempertahankan parameter string kueri.

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)

Parameter

path: String

Jalur URL halaman baru di server yang akan dijalankan.

preserveForm: Boolean

true untuk mempertahankan Form koleksi; false untuk menghapus Form koleksi.

Pengecualian

PlatformNotSupportedException

Permintaan ini memerlukan mode alur terintegrasi IIS 7.0.

HttpException

Server tidak tersedia untuk menangani permintaan.

ArgumentNullException

Parameternya path adalah null.

ArgumentException

Parameter path tidak valid.

Keterangan

Kelebihan beban ini memanggil TransferRequest kelebihan beban dengan parameter yang preserveForm diatur ke nilai yang diteruskan, method parameter diatur ke null, headers parameter diatur ke null, dan preserveUser parameter diatur ke true. Untuk informasi selengkapnya, lihat bagian "Keterangan" di TransferRequest(String, Boolean, String, NameValueCollection).

TransferRequest diperkenalkan dalam .NET Framework versi 3.5. Untuk informasi selengkapnya, lihat Versi dan Dependensi.

Berlaku untuk

TransferRequest(String, Boolean, String, NameValueCollection)

Melakukan eksekusi asinkron DARI URL yang ditentukan menggunakan metode dan header HTTP yang ditentukan.

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)

Parameter

path: String

Jalur URL halaman baru di server yang akan dijalankan.

preserveForm: Boolean

true untuk mempertahankan Form koleksi; false untuk menghapus Form koleksi.

method: String

Metode HTTP yang digunakan dalam eksekusi permintaan baru.

headers: NameValueCollection

Header NameValueCollection permintaan untuk permintaan baru.

Pengecualian

PlatformNotSupportedException

Permintaan ini memerlukan IIS 7.0 yang berjalan dalam mode terintegrasi.

HttpException

Server tidak tersedia untuk menangani permintaan.

ArgumentNullException

Parameternya path adalah null.

ArgumentException

Parameter path tidak valid.

Keterangan

Metode ini digunakan saat berjalan dengan mode alur terintegrasi di IIS 7.0 untuk memungkinkan pemrosesan permintaan ditransfer dari satu jenis sumber daya ke jenis sumber daya lainnya saat menjalankan permintaan target dengan konteks permintaan yang benar. Misalnya, Anda dapat menggunakan TransferRequest metode untuk mentransfer permintaan halaman ASPX ke permintaan halaman XML.

Metode ini TransferRequest melakukan eksekusi anak asinkron dari URL yang ditentukan dengan kondisi berikut:

path Jika parameter menentukan string kueri, parameter tersebut akan digunakan sebagai string kueri baru. Jika tidak ada string kueri yang disertakan, string kueri permintaan akan digunakan kembali.
method Jika parameter ditentukan, parameter akan digunakan. Jika ya null, metode HTTP dari permintaan asli akan digunakan.
preserveForm Jika parameter adalah true, badan entitas permintaan saat ini akan tersedia untuk permintaan target. Ini memungkinkan posting formulir dan unggahan untuk ditransfer.
Jika identitas pengguna saat ini diatur pada permintaan asli, identitas akan ditransfer ke permintaan baru. Ini memungkinkan permintaan terautentikasi untuk menggunakan kembali hasil autentikasi untuk permintaan baru. Jika Anda tidak ingin pengguna ditransfer, atur pengguna ke null pada permintaan asli sebelum mentransfer.
headers Jika parameter ditentukan, permintaan baru akan dijalankan dengan header yang ditentukan. Ini dapat digunakan untuk mengubah header permintaan dan cookie untuk permintaan baru, atau menambahkan header khusus yang menentukan tempat permintaan asli diterima.

Metode ini memanggil TransferRequest(String, Boolean, String, NameValueCollection, Boolean) metode kelebihan beban dengan parameter yang preserveUser diatur ke true.

Berlaku untuk

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

Melakukan eksekusi asinkron dari URL yang ditentukan menggunakan metode HTTP, header, dan jalur yang ditentukan, dan secara opsional mempertahankan nilai formulir dan identitas pengguna.

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)

Parameter

path: String

Jalur.

preserveForm: Boolean

true untuk mempertahankan Form koleksi; false untuk menghapus Form koleksi.

method: String

Metode HTTP yang digunakan dalam permintaan baru.

headers: NameValueCollection

Objek NameValueCollection yang berisi header permintaan untuk permintaan baru.

preserveUser: Boolean

true untuk mempertahankan identitas pengguna; jika tidak, false. Metode lain kelebihan beban metode ini memanggil kelebihan beban ini dengan parameter ini diatur ke true.

Pengecualian

PlatformNotSupportedException

Permintaan ini memerlukan mode alur terintegrasi IIS 7.0.

HttpException

Server tidak tersedia untuk menangani permintaan.

ArgumentNullException

Parameternya path adalah null.

ArgumentException

Parameter path tidak valid.

Keterangan

Untuk informasi selengkapnya, lihat bagian "Keterangan" di TransferRequest(String, Boolean, String, NameValueCollection).

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?