DependencyProperty.RegisterAttached Метод

Ссылка

Определение

Пространство имен:: System.Windows

Сборка:: WindowsBase.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Регистрирует присоединенное свойство в системе свойств.

Перегрузки

RegisterAttached(String, Type, Type)	Регистрирует присоединенное свойство с указанием имени свойства, типа свойства и типа владельца.
RegisterAttached(String, Type, Type, PropertyMetadata)	Регистрирует присоединенное свойство с указанным именем и типом свойства, типом владельца и метаданными свойства.
RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Регистрирует присоединенное свойство с указанным типом свойства, типом владельца, метаданными свойства и обратным вызовом для проверки значения свойства.

RegisterAttached(String, Type, Type)

Регистрирует присоединенное свойство с указанием имени свойства, типа свойства и типа владельца.

public:
 static System::Windows::DependencyProperty ^ RegisterAttached(System::String ^ name, Type ^ propertyType, Type ^ ownerType);

public static System.Windows.DependencyProperty RegisterAttached (string name, Type propertyType, Type ownerType);

static member RegisterAttached : string * Type * Type -> System.Windows.DependencyProperty

Public Shared Function RegisterAttached (name As String, propertyType As Type, ownerType As Type) As DependencyProperty

Параметры

name: String

Имя регистрируемого свойства зависимостей.

propertyType: Type

Тип свойства.

ownerType: Type

Тип владельца, регистрирующего свойство зависимостей.

Возвращаемое значение

DependencyProperty

Идентификатор свойства зависимостей, который должен использоваться для задания значения поля public static readonly в классе. Затем этот идентификатор используется для ссылки на свойство зависимостей для операций, например задания значения программным образом или получение метаданных.

Примеры

В следующем примере регистрируется присоединенное свойство в абстрактном классе с помощью этой RegisterAttached сигнатуры.

public static readonly DependencyProperty IsBubbleSourceProperty = DependencyProperty.RegisterAttached(
  "IsBubbleSource",
  typeof(Boolean),
  typeof(AquariumObject2)
);
public static void SetIsBubbleSource(UIElement element, Boolean value)
{
    element.SetValue(IsBubbleSourceProperty, value);
}
public static Boolean GetIsBubbleSource(UIElement element)
{
    return (Boolean)element.GetValue(IsBubbleSourceProperty);
}

Public Shared ReadOnly IsBubbleSourceProperty As DependencyProperty = DependencyProperty.RegisterAttached("IsBubbleSource", GetType(Boolean), GetType(AquariumObject2))
Public Shared Sub SetIsBubbleSource(ByVal element As UIElement, ByVal value As Boolean)
    element.SetValue(IsBubbleSourceProperty, value)
End Sub
Public Shared Function GetIsBubbleSource(ByVal element As UIElement) As Boolean
    Return CType(element.GetValue(IsBubbleSourceProperty), Boolean)
End Function

Присоединенное свойство — это концепция свойства, определяемая языком разметки приложений (XAML). WPF реализует присоединенные свойства в качестве свойств зависимостей. Так как присоединенные свойства WPF являются свойствами зависимостей, они могут применять метаданные, которые могут использоваться общей системой свойств для таких операций, как характеристики макета отчетов. Дополнительные сведения см. в разделе Общие сведения о вложенных свойствах.

Дополнительные сведения о регистрации свойств зависимостей см. в разделе DependencyProperty.

См. также раздел

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

RegisterAttached(String, Type, Type, PropertyMetadata)

Регистрирует присоединенное свойство с указанным именем и типом свойства, типом владельца и метаданными свойства.

public:
 static System::Windows::DependencyProperty ^ RegisterAttached(System::String ^ name, Type ^ propertyType, Type ^ ownerType, System::Windows::PropertyMetadata ^ defaultMetadata);

public static System.Windows.DependencyProperty RegisterAttached (string name, Type propertyType, Type ownerType, System.Windows.PropertyMetadata defaultMetadata);

static member RegisterAttached : string * Type * Type * System.Windows.PropertyMetadata -> System.Windows.DependencyProperty

Public Shared Function RegisterAttached (name As String, propertyType As Type, ownerType As Type, defaultMetadata As PropertyMetadata) As DependencyProperty

Параметры

name: String

Имя регистрируемого свойства зависимостей.

propertyType: Type

Тип свойства.

ownerType: Type

Тип владельца, регистрирующего свойство зависимостей.

defaultMetadata: PropertyMetadata

Метаданные свойства зависимостей. Могут включать значение по умолчанию и другие характеристики.

Возвращаемое значение

DependencyProperty

Использование RegisterAttached для свойств зависимостей наследования значений

Один из конкретных сценариев регистрации свойства RegisterAttached зависимостей вместо того, чтобы поддерживать наследование значений Register свойства. Следует регистрировать свойства RegisterAttached зависимостей, наследующие значения, даже если класс определяет методы доступа к оболочке свойств, которые предоставляют свойство зависимостей, и даже если вы не планируете предоставлять статические методы Get* и Set*, чтобы предоставить истинные присоединенные свойства поддерживают методы доступа. Несмотря на то что наследование значений свойств может работать для некташированных свойств зависимостей, поведение наследования для некташированного свойства через определенные границы элементов в дереве среды выполнения не определено. Регистрация свойства как присоединенного эффективно делает присоединенное свойство глобальным свойством в системе свойств и гарантирует, что наследование значений свойств работает по всем границам дерева элементов. Для регистрации свойств всегда используйте RegisterAttached, если в метаданных указываете Inherits. Дополнительные сведения см. в разделе Наследование значения свойства.

См. также раздел

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

RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)

Регистрирует присоединенное свойство с указанным типом свойства, типом владельца, метаданными свойства и обратным вызовом для проверки значения свойства.

public:
 static System::Windows::DependencyProperty ^ RegisterAttached(System::String ^ name, Type ^ propertyType, Type ^ ownerType, System::Windows::PropertyMetadata ^ defaultMetadata, System::Windows::ValidateValueCallback ^ validateValueCallback);

public static System.Windows.DependencyProperty RegisterAttached (string name, Type propertyType, Type ownerType, System.Windows.PropertyMetadata defaultMetadata, System.Windows.ValidateValueCallback validateValueCallback);

static member RegisterAttached : string * Type * Type * System.Windows.PropertyMetadata * System.Windows.ValidateValueCallback -> System.Windows.DependencyProperty

Public Shared Function RegisterAttached (name As String, propertyType As Type, ownerType As Type, defaultMetadata As PropertyMetadata, validateValueCallback As ValidateValueCallback) As DependencyProperty

Параметры

name: String

Имя регистрируемого свойства зависимостей.

propertyType: Type

Тип свойства.

ownerType: Type

Тип владельца, регистрирующего свойство зависимостей.

defaultMetadata: PropertyMetadata

Метаданные свойства зависимостей. Могут включать значение по умолчанию и другие характеристики.

validateValueCallback: ValidateValueCallback

Ссылка на обратный вызов, который должен выполнить пользовательскую проверку значения свойства зависимостей после обычной проверки типа.

Возвращаемое значение

DependencyProperty

Примеры

В следующем примере регистрируется присоединенное свойство в абстрактном классе с помощью этой RegisterAttached сигнатуры. Это присоединенное свойство является свойством типа перечисления, а регистрация добавляет обратный вызов проверки, чтобы убедиться, что указанное значение является значением перечисления.

public static readonly DependencyProperty IsBubbleSourceProperty = DependencyProperty.RegisterAttached(
  "IsBubbleSource",
  typeof(Boolean),
  typeof(AquariumObject2)
);
public static void SetIsBubbleSource(UIElement element, Boolean value)
{
    element.SetValue(IsBubbleSourceProperty, value);
}
public static Boolean GetIsBubbleSource(UIElement element)
{
    return (Boolean)element.GetValue(IsBubbleSourceProperty);
}

Public Shared ReadOnly IsBubbleSourceProperty As DependencyProperty = DependencyProperty.RegisterAttached("IsBubbleSource", GetType(Boolean), GetType(AquariumObject2))
Public Shared Sub SetIsBubbleSource(ByVal element As UIElement, ByVal value As Boolean)
    element.SetValue(IsBubbleSourceProperty, value)
End Sub
Public Shared Function GetIsBubbleSource(ByVal element As UIElement) As Boolean
    Return CType(element.GetValue(IsBubbleSourceProperty), Boolean)
End Function

Использование RegisterAttached для свойств зависимостей наследования значений

См. также раздел

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

DependencyProperty.RegisterAttached Метод

Определение

Перегрузки

RegisterAttached(String, Type, Type)

Параметры

Возвращаемое значение

Примеры

Комментарии

См. также раздел

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

RegisterAttached(String, Type, Type, PropertyMetadata)

Параметры

Возвращаемое значение

Комментарии

Использование RegisterAttached для свойств зависимостей наследования значений

См. также раздел

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

RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)

Параметры

Возвращаемое значение

Примеры

Комментарии

Использование RegisterAttached для свойств зависимостей наследования значений

См. также раздел

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

Дополнительные ресурсы