DependencyProperty.Register Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Регистрирует свойство зависимости с указанным именем свойства, типом свойства, типом владельца и метаданными свойства для свойства. Используйте этот метод при определении или инициализации производного класса DependencyObject , который будет владеть зарегистрированным свойством зависимостей.
static DependencyProperty Register(winrt::hstring const& name, TypeName const& propertyType, TypeName const& ownerType, PropertyMetadata const& typeMetadata);public static DependencyProperty Register(string name, System.Type propertyType, System.Type ownerType, PropertyMetadata typeMetadata);function register(name, propertyType, ownerType, typeMetadata)Public Shared Function Register (name As String, propertyType As Type, ownerType As Type, typeMetadata As PropertyMetadata) As DependencyPropertyПараметры
- name
-
String
winrt::hstring
Имя регистрируемого свойства зависимостей.
Тип свойства в виде ссылки на тип (System.Type для Microsoft .NET, вспомогательная структуру TypeName для расширений компонентов Visual C++ (C++/CX)).
Тип владельца, регистрирующий свойство зависимостей в качестве ссылки на тип (System.Type для Microsoft .NET, вспомогательная структуру TypeName для расширений компонентов Visual C++ (C++/CX)).
- typeMetadata
- PropertyMetadata
Экземпляр метаданных свойства. Он может содержать значение по умолчанию и ссылку на реализацию PropertyChangedCallback . Передача null для этого параметра эквивалентна передаче нового экземпляра PropertyMetadata, созданного путем вызова PropertyMetadata.Create с в null качестве параметра значения по умолчанию.
Возвращаемое значение
Идентификатор свойства зависимостей, который обычно хранится в общедоступном статическом поле только для чтения в производном классе DependencyObject . Затем идентификатор используется как собственным кодом, так и любым сторонним пользовательским кодом для последующей ссылки на свойство зависимостей для таких операций, как установка его значения программными средствами или присоединение привязки в коде.
Комментарии
Регистрация пользовательского свойства зависимостей подробно описана (с примерами) в разделе Пользовательские свойства зависимостей.
Регистрация свойства зависимостей обычно выполняется только при первом запуске приложения или при первом использовании производных классов DependencyObject , определенных в коде приложения. Необходимо зарегистрировать свойства зависимостей в начале времени существования приложения, чтобы убедиться, что другие код и XAML в приложении не пытаются использовать свойства зависимостей, прежде чем они будут зарегистрированы и доступны. Способ и время регистрации зависит от языка программирования. Для C# или Microsoft Visual Basic свойства зависимостей обычно регистрируются во время инициализации статического класса класса, которому принадлежит свойство зависимостей. Таким образом, любой код или XAML, который инициализирует экземпляр, будет вызывать статическую конструкцию и регистрировать свойство зависимостей. Для расширений компонентов Visual C++ (C++/CX)статическая инициализация класса не является доступной методикой, поэтому обычно необходимо определить вспомогательный метод на уровне приложения, который регистрирует все пользовательские свойства зависимостей, которые планирует использовать приложение, в рамках инициализации объекта Application . Примеры того, как и когда регистрировать настраиваемые свойства зависимостей, включая некоторые специальные методы, необходимые для расширений компонентов Visual C++ (C++/CX), см. в разделе Пользовательские свойства зависимостей.