WebPartManager.CreateErrorWebPart Yöntem

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls.WebParts

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Herhangi bir nedenle dinamik WebPart denetim yükleme veya oluşturma girişimi başarısız olduğunda, sayfaya eklenen ve son kullanıcılar için görüntülenen özel bir denetim oluşturur.

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

Parametreler

originalID: String

Başarısız denetimin kimliği olan bir dize. hataya dahil olan kimlik GenericWebPart , alt sunucu denetiminin kimliğidir.

originalTypeName: String

Başarısız denetimin Type adı olan bir dize. GenericWebPart Hataya bir dahilse, tür adı alt sunucu denetiminin türüdür.

originalPath: String

Hataya alt kullanıcı denetimi içeren bir GenericWebPart kullanıcı denetiminin yolunu içeren bir dize.

genericWebPartID: String

Denetim yükleme veya oluşturma hatasına bu tür bir GenericWebPartdenetim dahil edildiyse, kimliğini döndüren dize.

errorMessage: String

Sayfada görüntülenecek hata iletisini içeren bir dize.

Döndürülenler

ErrorWebPart

ErrorWebPart Yüklenemeyen veya oluşturulamayan bir denetimin yerine sayfaya eklenen.

Açıklamalar

CreateErrorWebPart Yöntemi, Web Bölümleri denetim kümesi bir dinamik WebPart veya sunucu denetiminin örneğini yüklemeyi veya oluşturmayı denediğinde çağrılır ve herhangi bir nedenle başarısız olur. yöntemi bir ErrorWebPart nesne oluşturur, nesneye bir hata iletisi atar ve döndürür. Başarısız ErrorWebPart olan denetimin yerine denetim eklenir ve sayfada hata iletisi görüntülenir.

yöntemini doğrudan kodunuzdan çağıramazsınız CreateErrorWebPart . Ancak, sınıfından WebPartManager devralabilir ve yöntemini genişletebilirsiniz. Ayrıntılar için Devralıcılar için Notlar bölümüne bakın.

Son kullanıcılar, normal WebPart bir ErrorWebPart denetim gibi sayfadaki bir denetimle çalışabilir. Hata iletisini kaldırmak için kapatma fiiline tıklayarak denetimi kapatabilirler; bu noktada denetim, diğer kapalı denetimler gibi bir PageCatalogPart nesneye eklenir. Bir son kullanıcı denetimi ErrorWebPart silerse, yüklenemeyen sunucu denetimi de sayfadan silinir.

Devralanlara Notlar

Denetimde ErrorWebPart döndürülen bilgileri özelleştirmek istiyorsanız, yöntemini geçersiz kılabilir CreateErrorWebPart(String, String, String, String, String) , temel yöntemi çağırabilir, temel yönteme geçirilen parametrelere farklı değerler atayabilir ve ardından sonuçta elde ErrorWebPart edilen denetimi döndürebilirsiniz. Örneğin, son kullanıcıların değerini görmesini originalPath istemiyorsanız (bir kullanıcı denetiminin sanal dizin yolunu gösterir), temel yöntemi çağırdığınızda bu parametre için boş bir dize ("") geçirebilirsiniz.

Ayrıca, denetimin ErrorWebPart kendisinden devralarak davranışını özelleştirebilirsiniz. Örneğin, veya AllowMinimize özelliğini geçersiz kılmak Title isteyebilirsiniz.

Şunlara uygulanır

Aracılığıyla paylaş