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