WebPartManager.CreateErrorWebPart Metode

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls.WebParts

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.

Membuat kontrol khusus yang dimasukkan ke dalam halaman dan ditampilkan untuk pengguna akhir, ketika upaya untuk memuat atau membuat kontrol dinamis WebPart gagal karena beberapa alasan.

protected:
 virtual System::Web::UI::WebControls::WebParts::ErrorWebPart ^ CreateErrorWebPart(System::String ^ originalID, System::String ^ originalTypeName, System::String ^ originalPath, System::String ^ genericWebPartID, System::String ^ errorMessage);

protected virtual System.Web.UI.WebControls.WebParts.ErrorWebPart CreateErrorWebPart (string originalID, string originalTypeName, string originalPath, string genericWebPartID, string errorMessage);

abstract member CreateErrorWebPart : string * string * string * string * string -> System.Web.UI.WebControls.WebParts.ErrorWebPart
override this.CreateErrorWebPart : string * string * string * string * string -> System.Web.UI.WebControls.WebParts.ErrorWebPart

Protected Overridable Function CreateErrorWebPart (originalID As String, originalTypeName As String, originalPath As String, genericWebPartID As String, errorMessage As String) As ErrorWebPart

Parameter

originalID: String

String yang merupakan ID kontrol yang gagal. GenericWebPart Jika terlibat dalam kegagalan, ID adalah ID kontrol server anaknya.

originalTypeName: String

String yang merupakan nama Type kontrol yang gagal. GenericWebPart Jika terlibat dalam kegagalan, nama jenis adalah jenis kontrol server turunannya.

originalPath: String

String yang berisi jalur ke kontrol pengguna, jika GenericWebPart yang berisi kontrol pengguna anak terlibat dalam kegagalan.

genericWebPartID: String

String yang mengembalikan ID dari GenericWebPart, jika jenis kontrol tersebut terlibat dalam kegagalan untuk memuat atau membuat kontrol.

errorMessage: String

String yang berisi pesan kesalahan untuk ditampilkan di halaman.

Mengembalikan

ErrorWebPart

Yang ErrorWebPart disisipkan ke dalam halaman sebagai pengganti kontrol yang gagal dimuat atau dibuat.

Keterangan

Metode CreateErrorWebPart ini dipanggil ketika set kontrol Bagian Web mencoba memuat atau membuat contoh kontrol dinamis WebPart atau server, dan gagal karena beberapa alasan. Metode ini membuat ErrorWebPart objek, menetapkan pesan kesalahan ke objek tersebut, dan mengembalikannya. ErrorWebPart Kontrol disisipkan sebagai pengganti kontrol yang gagal, dan pesan kesalahannya ditampilkan di halaman.

Anda tidak dapat memanggil metode langsung CreateErrorWebPart dari kode Anda. Namun, Anda dapat mewarisi dari WebPartManager kelas dan memperluas metode . Untuk detailnya, lihat bagian Catatan untuk Pewaris.

Pengguna akhir dapat bekerja dengan ErrorWebPart kontrol di halaman seperti kontrol normal WebPart . Untuk menghapus pesan kesalahan, mereka dapat menutup kontrol dengan mengklik kata kerja tutup, di mana kontrol akan ditambahkan ke PageCatalogPart objek, seperti kontrol tertutup lainnya. Jika pengguna akhir menghapus ErrorWebPart kontrol, kontrol server yang gagal dimuat juga akan dihapus dari halaman.

Catatan Bagi Inheritor

Jika Anda ingin menyesuaikan informasi yang dikembalikan dalam ErrorWebPart kontrol, Anda dapat mengambil CreateErrorWebPart(String, String, String, String, String) alih metode , memanggil metode dasar, menetapkan nilai yang berbeda ke parameter yang diteruskan ke metode dasar, lalu mengembalikan kontrol yang ErrorWebPart dihasilkan. Misalnya, jika Anda tidak ingin pengguna akhir melihat originalPath nilai (yang akan menampilkan jalur direktori virtual kontrol pengguna), ketika Anda memanggil metode dasar, Anda dapat meneruskan string kosong ("") untuk parameter tersebut.

Anda juga dapat menyesuaikan perilaku kontrol itu ErrorWebPart sendiri, dengan mewarisinya. Misalnya, Anda mungkin ingin mengambil alih properti atau AllowMinimize .Title

Berlaku untuk

Bagikan melalui