ConstructorArgumentAttribute Класс

Определение

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

System.Windows.Markup

Сборка:

System.Xaml.dll

Указывает, что объект может быть инициализирован с помощью синтаксиса конструктора, не являющегося конструктором без параметров, и что информация о конструкции предоставляется свойством указанного имени. Эта информация предназначена главным образом для сериализации XAML.

public ref class ConstructorArgumentAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Property, AllowMultiple=false, Inherited=false)]
public sealed class ConstructorArgumentAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Property, AllowMultiple=false, Inherited=false)>]
type ConstructorArgumentAttribute = class
    inherit Attribute

Public NotInheritable Class ConstructorArgumentAttribute
Inherits Attribute

Наследование

Object

Attribute

ConstructorArgumentAttribute

Атрибуты

AttributeUsageAttribute

Комментарии

Этот атрибут указывает, что связанное свойство может быть инициализировано параметром конструктора и должно игнорироваться для сериализации XAML, если конструктор используется для создания экземпляра . Это обеспечивает лучшее представление кругового пути для параметризованного синтаксиса конструктора, а не создания экземпляра конструктора без параметров и конкретных атрибутов.

Платформа потенциально может поддерживать сохранение использования расширений разметки и их воссоздание, а не полагаться на выходные ProvideValue данные в дереве объектов для сериализации. В этом случае ConstructorArgumentAttribute эти сведения полезны во время сериализации, чтобы получить точное представление о типичном использовании расширения разметки. Дополнительные сведения о расширениях разметки см. в разделе Markup Extensions for XAML Overview.

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

Потребители ConstructorArgumentAttribute могут вызывать исключение в случаях, когда ArgumentName не разрешается в типы поддержки, или при применении к типу, который не имеет соответствующих аргументов конструкции и arity.

В предыдущих версиях платформа .NET Framework этот класс существовал в сборке WindowsBase для WPF. В платформа .NET Framework 4 ConstructorArgumentAttribute находится в сборке System.Xaml. Для получения дополнительной информации см. Types Migrated from WPF to System.Xaml.

Примечания об использовании WPF

Дополнительные сведения о расширениях разметки и WPF см. в разделе Расширения разметки и XAML WPF.

Конструкторы

ConstructorArgumentAttribute(String)

Инициализирует новый экземпляр класса ConstructorArgumentAttribute.

Свойства

ArgumentName	Получает имя параметра конструктора, который будет инициализировать связанное свойство.
TypeId	В случае реализации в производном классе возвращает уникальный идентификатор для этого атрибута Attribute. (Унаследовано от Attribute)

Методы

Equals(Object)	Возвращает значение, показывающее, равен ли экземпляр указанному объекту. (Унаследовано от Attribute)
GetHashCode()	Возвращает хэш-код данного экземпляра. (Унаследовано от Attribute)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
IsDefaultAttribute()	При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса. (Унаследовано от Attribute)
Match(Object)	При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту. (Унаследовано от Attribute)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

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

• MarkupExtension
• Атрибуты СРЕДЫ CLR, связанные с XAML, для пользовательских типов и библиотек
• Определение пользовательских типов для использования со службами XAML .NET
• Службы XAML
• Преобразователи типов или расширения разметки для XAML