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.

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

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

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

Идентификатор свойства зависимостей, который следует использовать для задания значения 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)

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

Идентификатор свойства зависимостей, который следует использовать для задания значения 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)