ControlDesigner.RegisterClone(Object, Object) Метод

Определение

Регистрирует внутренние данные в клонированном элементе управления.Registers internal data in a cloned control.

public:
 void RegisterClone(System::Object ^ original, System::Object ^ clone);
public void RegisterClone (object original, object clone);
member this.RegisterClone : obj * obj -> unit
Public Sub RegisterClone (original As Object, clone As Object)

Параметры

original
Object

Элемент управления, сопоставленный с конструктором элементов управления.The control associated with the control designer.

clone
Object

Клонированная копия сопоставленного элемента управления.The cloned copy of the associated control.

Исключения

Параметр original имеет значение null.original is null.

-или--or- Параметр clone имеет значение null.clone is null.

Комментарии

При клонировании элемента могут существовать некоторые внутренние структуры данных, такие как meta: атрибуты, которые должны включаться в клонированный элемент управления конструктором элементов управления.Whenever an item is cloned, there might be some internal data structures, such as meta: attributes, that should be included in the cloned control by the control designer. Разработчик страницы может добавлять meta: атрибуты к разметке элемента управления, и не существует способа, чтобы элемент управления мог отличать эти теги.A page developer might add meta: attributes to the markup of a control and there is no way, nor is there a reason, for the control to distinguish what those tags might be. Таким образом, если конструктор элементов управления предоставляет способ редактирования сложных свойств или форматов перед применением изменений к странице, необходимо создать клон элемента управления, передать как исходный элемент управления, так и клон в этот метод RegisterClone, а затем, когда изменения будут сохранены в теге, все meta: атрибуты также сохраняются.Therefore, if your control designer provides a way to edit complex properties or formats before applying changes to a page, you would create a clone of the control, pass both the original control and the clone to this RegisterClone method, and then, when the changes are persisted to the tag, all meta: attributes are also persisted.

Применяется к

Дополнительно