Aracılığıyla paylaş


WebPartManager.CopyWebPart(WebPart) Yöntem

Tanım

Web Bölümleri denetim kümesi tarafından, denetimi web sayfasına eklemek amacıyla bir WebPart veya sunucu denetiminin kopyasını oluşturmak için kullanılır.

protected:
 virtual System::Web::UI::WebControls::WebParts::WebPart ^ CopyWebPart(System::Web::UI::WebControls::WebParts::WebPart ^ webPart);
protected virtual System.Web.UI.WebControls.WebParts.WebPart CopyWebPart (System.Web.UI.WebControls.WebParts.WebPart webPart);
abstract member CopyWebPart : System.Web.UI.WebControls.WebParts.WebPart -> System.Web.UI.WebControls.WebParts.WebPart
override this.CopyWebPart : System.Web.UI.WebControls.WebParts.WebPart -> System.Web.UI.WebControls.WebParts.WebPart
Protected Overridable Function CopyWebPart (webPart As WebPart) As WebPart

Parametreler

webPart
WebPart

Kopyalanacak WebPart veya sunucu denetimi.

Döndürülenler

Bir WebPart sayfaya eklenecek A.

Açıklamalar

Yöntemini doğrudan kodunuzdan çağıramazsınız CopyWebPart . Bu yöntem, bir sayfaya WebPartManager yeni bir dinamik WebPart veya sunucu denetimi ekleme işleminin bir parçası olarak denetim tarafından dahili olarak çağrılır. Dinamik denetim, bir sayfaya program aracılığıyla veya Web Bölümleri kullanıcı arabirimi (UI) aracılığıyla eklenir. Örneğin, bir kullanıcı, doğrudan sayfanın işaretlemesinde bildirilen statik denetimin aksine, denetim kataloğundan denetim ekler.

Not

Geliştiriciler ek denetim kopyalama senaryolarını işlemek için yöntemini etkinleştirmek istiyorsa, yöntemi türetilmiş bir sınıfta geçersiz kılınabilir. Ayrıntılar için Devralanlara Notlar bölümüne bakın.

Yeni bir dinamik denetim eklendiğinde, bu bir WebPart denetimse yöntemi denetimin CopyWebPart yeni bir örneğini döndürür. Eklenen denetim başka bir tür sunucu denetimiyse (kullanıcı denetimi, özel denetim veya ASP.NET denetimi gibi), denetim Web Bölümleri denetim kümesi tarafından zaten bir GenericWebPart nesneyle sarmalanmış olur. Yöntem bir GenericWebPart denetimle karşılaştığındaCopyWebPart, denetimin GenericWebPart içinde sarmalanmış yeni bir alt denetim örneğiyle yeni bir örneğini döndürür.

CopyWebPart Yöntemi, döndürülecek bir denetimin yeni bir kopyasını oluşturduğunda, tüm özelliklerin değerlerini de varsayılan değerlerine sıfırlar. Kişiselleştirilebilir özelliklerin değerlerini korumak ve bunları yeni denetim örneğine kopyalamak istiyorsanız yöntemini de çağırmanız CopyPersonalizationState gerektiğini unutmayın. yöntemi tarafından CopyWebPart gerçekleştirilen son adım, denetim için yeni bir kimlik almak üzere yöntemini çağırmaktır CreateDynamicWebPartID .

Not

yöntemi kopyalanan denetim için yeni bir kimlik elde ettiğinden, bir sayfaya özgün kimliğiyle eklenen dinamik denetime başvurmaya güvenmemelisiniz. Bunun yerine, yöntemi tarafından döndürülen denetimin yeni örneğine başvurmanız gerekir.

Devralanlara Notlar

geliştiricilerin sınıfından WebPartManager devralma, yöntemi geçersiz kılma ve denetimlerin kopyalarını oluşturabileceği ek senaryolar sağlamak için yöntemi olarak virtual bildirilir. Örneğin, yöntemi isteğe bağlı olarak xml dosyasında seri hale getirilmiş bir denetim girişi olarak alabilir. yöntemi XML'i seri durumdan kaldırabilir (varsa) ve ardından mevcut durumları işlemek ve denetimin yeni bir örneğini WebPart döndürmek için temel yöntemi çağırabilir.

Şunlara uygulanır

Ayrıca bkz.