WebPartManager.CopyWebPart(WebPart) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls.WebParts

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Służy do tworzenia kopii kontrolki składników WebPart Web Part lub serwera w celu dodania kontrolki do strony sieci Web.

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

Parametry

webPart: WebPart

Kontrolka WebPart lub serwera do skopiowania.

Zwraca

WebPart

Element do WebPart dodania do strony.

Uwagi

Nie można wywołać CopyWebPart metody bezpośrednio z kodu. Ta metoda jest wywoływana wewnętrznie przez kontrolkę WebPartManager w ramach procesu dodawania nowej kontrolki dynamicznej WebPart lub serwera do strony. Kontrolka dynamiczna jest dodawana do strony programowo lub za pośrednictwem interfejsu użytkownika składników Web Part, na przykład przez użytkownika dodającego kontrolkę z katalogu kontrolek, w przeciwieństwie do kontrolki statycznej, która jest zadeklarowana bezpośrednio w znacznikach strony.

Uwaga

Metoda może zostać zastąpiona w klasie pochodnej, jeśli deweloperzy chcą włączyć metodę do obsługi dodatkowych scenariuszy kopiowania kontrolek. Aby uzyskać szczegółowe informacje, zobacz sekcję Uwagi do dziedziczenia.

Po dodaniu nowej kontrolki dynamicznej WebPart , jeśli jest to kontrolka, CopyWebPart metoda zwraca nowe wystąpienie kontrolki. Jeśli dodawana kontrolka jest innym typem kontrolki serwera (np. kontrolką użytkownika, kontrolką niestandardową lub kontrolką ASP.NET), kontrolka zostanie już opakowana obiektem GenericWebPart przez zestaw kontrolek składników Web Part. Gdy CopyWebPart metoda napotka kontrolkę GenericWebPart , zwraca nowe wystąpienie kontrolki GenericWebPart z nowym wystąpieniem kontrolki podrzędnej opakowanej w niej.

Gdy CopyWebPart metoda tworzy nową kopię kontrolki do zwrócenia, resetuje również wartości wszystkich właściwości do ich wartości domyślnych. Należy pamiętać, że jeśli chcesz zachować wartości właściwości nadających się do personalizacji i skopiować je do nowego wystąpienia kontrolki, należy również wywołać metodę CopyPersonalizationState . Ostatnim krokiem wykonywanym przez CopyWebPart metodę jest wywołanie CreateDynamicWebPartID metody w celu uzyskania nowego identyfikatora kontrolki.

Uwaga

Ponieważ metoda uzyskuje nowy identyfikator skopiowanej kontrolki, nie należy polegać na odwoływania się do kontrolki dynamicznej dodawanej do strony przy użyciu oryginalnego identyfikatora. Zamiast tego należy odwołać się do nowego wystąpienia kontrolki zwróconej przez metodę .

Uwagi dotyczące dziedziczenia

Metoda jest zadeklarowana tak virtual , aby deweloperzy mogli dziedziczyć z WebPartManager klasy, zastąpić metodę i zapewnić dodatkowe scenariusze, w których może tworzyć kopie kontrolek. Na przykład metoda może opcjonalnie odbierać jako dane wejściowe kontrolkę, która została serializowana w pliku XML. Metoda może deserializować kod XML (jeśli istnieje), a następnie wywołać metodę podstawową, aby obsłużyć istniejące przypadki i zwrócić nowe wystąpienie kontrolki WebPart .

Dotyczy

Udostępnij za pośrednictwem