WebPartManager.CopyWebPart(WebPart) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Используется набором элементов управления веб-частей для создания копии WebPart или серверного элемента управления для добавления элемента управления на веб-страницу.
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 WebPartПараметры
Возвращаемое значение
Объект WebPart, добавляемый на страницу.
Комментарии
Метод нельзя вызывать CopyWebPart непосредственно из кода. Этот метод вызывается внутри WebPartManager элемента управления как часть процесса добавления нового динамического WebPart или серверного элемента управления на страницу. Динамический элемент управления добавляется на страницу программным способом или через пользовательский интерфейс веб-части, например путем добавления пользователем элемента управления из каталога элементов управления, а не статического элемента управления, который объявляется непосредственно в разметке страницы.
Примечание
Метод можно переопределить в производном классе, если разработчики хотят разрешить методу обрабатывать дополнительные сценарии копирования элементов управления. Дополнительные сведения см. в разделе "Заметки к наследуемым".
При добавлении нового динамического элемента управления, если он является элементом WebPart управления, CopyWebPart метод возвращает новый экземпляр элемента управления. Если добавляемый элемент управления является другим типом серверного элемента управления (например, пользовательского элемента управления, пользовательского элемента управления или элемента управления ASP.NET), элемент управления уже будет заключен в GenericWebPart объект набором элементов управления веб-части. CopyWebPart Когда метод обнаруживает GenericWebPart элемент управления, он возвращает новый экземпляр GenericWebPart элемента управления с новым экземпляром дочернего элемента управления, заключенный в него.
CopyWebPart Когда метод создает новую копию элемента управления для возврата, он также сбрасывает значения всех свойств до значений по умолчанию. Обратите внимание, что если вы хотите сохранить значения персонализированных свойств и скопировать их в новый экземпляр элемента управления, следует также вызвать CopyPersonalizationState метод. Последним шагом, выполняемым методом CopyWebPart , является вызов CreateDynamicWebPartID метода для получения нового идентификатора элемента управления.
Примечание
Так как метод получает новый идентификатор скопированного элемента управления, не следует ссылаться на динамический элемент управления, добавляемый на страницу по исходному идентификатору. Вместо этого следует ссылаться на новый экземпляр элемента управления, возвращаемого методом.
Примечания для тех, кто наследует этот метод
Метод объявляется так virtual , чтобы разработчики могли наследовать от WebPartManager класса, переопределять метод и предоставлять дополнительные сценарии, в которых он может создавать копии элементов управления. Например, метод может при необходимости получить в качестве входных данных элемент управления, сериализованный в XML-файл. Метод может десериализировать XML (если он присутствует), а затем вызвать базовый метод для обработки существующих случаев и возвращения нового экземпляра WebPart элемента управления.