DependencyProperty.RegisterAttached Метод

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

Параметры

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

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.

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

• Register(String, Type, Type, PropertyMetadata)
• RegisterAttachedReadOnly(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

Параметры

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

DependencyProperty

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

Комментарии

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

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

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

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

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

• Register(String, Type, Type, PropertyMetadata)
• RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)

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

Параметры

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

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 для свойств зависимостей наследования значений

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

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

• Register(String, Type, Type, PropertyMetadata)
• RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)