WebPartManager.CopyWebPart(WebPart) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Používá se v sadě ovládacích WebPart prvků webové části k vytvoření kopie ovládacího prvku nebo serveru za účelem přidání ovládacího prvku na webovou stránku.
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.WebPartProtected Overridable Function CopyWebPart (webPart As WebPart) As WebPartParametry
Návraty
A WebPart , které se mají přidat na stránku.
Poznámky
Metodu CopyWebPart nelze volat přímo z kódu. Tuto metodu volá interně WebPartManager ovládací prvek jako součást procesu přidání nového dynamického WebPart nebo serverového ovládacího prvku na stránku. Dynamický ovládací prvek se na stránku přidá programově nebo prostřednictvím uživatelského rozhraní webových částí, například přidáním ovládacího prvku z katalogu ovládacích prvků, nikoli statickým ovládacím prvkům, který je deklarován přímo ve značkách stránky.
Poznámka
Metodu lze přepsat v odvozené třídě, pokud vývojáři chtějí povolit metodu pro zpracování dalších scénářů kopírování řízení. Podrobnosti najdete v části Poznámky pro dědíky.
Při přidání nového dynamického ovládacího prvku, pokud se jedná o WebPart ovládací prvek, CopyWebPart vrátí metoda novou instanci ovládacího prvku. Pokud je přidávaný ovládací prvek jiným typem serverového ovládacího prvku (například uživatelský ovládací prvek, vlastní ovládací prvek nebo ovládací prvek ASP.NET), bude již ovládací prvek zabalen s GenericWebPart objektem pomocí sady ovládacích prvků webových částí. CopyWebPart Když metoda narazí na GenericWebPart ovládací prvek, vrátí novou instanci GenericWebPart ovládacího prvku s novou instancí podřízeného ovládacího prvku.
CopyWebPart Když metoda vytvoří novou kopii ovládacího prvku, který se má vrátit, obnoví také hodnoty všech vlastností na výchozí hodnoty. Všimněte si, že pokud chcete zachovat hodnoty přizpůsobitelných vlastností a zkopírovat je do nové instance ovládacího prvku, měli byste také volat metodu CopyPersonalizationState . Posledním krokem provedeným metodou CopyWebPart je volání CreateDynamicWebPartID metody pro získání nového ID ovládacího prvku.
Poznámka
Vzhledem k tomu, že metoda získá nové ID pro zkopírovaný ovládací prvek, neměli byste spoléhat na odkazování na dynamický ovládací prvek, který je přidán na stránku jeho původní ID. Místo toho byste měli odkazovat na novou instanci ovládacího prvku vráceného metodou.
Poznámky pro dědice
Metoda je deklarována tak virtual , aby vývojáři mohli dědit z WebPartManager třídy, přepsat metodu a poskytnout další scénáře, ve kterých by mohla vytvářet kopie ovládacích prvků. Například metoda může volitelně přijmout jako vstup ovládací prvek, který byl serializován do souboru XML. Metoda může deserializovat XML (pokud je k dispozici) a pak volat základní metodu pro zpracování existujících případů a vrácení nové instance WebPart ovládacího prvku.
