ConstructorArgumentAttribute Classe

Definição

Namespace:

System.Windows.Markup

Assembly:

System.Xaml.dll

Especifica que um objeto pode ser inicializado usando uma sintaxe de construtor que não seja sem parâmetros e que uma propriedade do nome especificado fornece informações de construção. Essas informações são principalmente para serialização 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

Herança

Object

Attribute

ConstructorArgumentAttribute

Atributos

AttributeUsageAttribute

Comentários

Esse atributo especifica que a propriedade associada pode ser inicializada por um parâmetro de construtor e deve ser ignorada para serialização XAML se o construtor for usado para construir a instância. Isso fornece melhores representações de ida e volta para sintaxe de construtor com parâmetros em vez de instanciação de construtor sem parâmetros, além de atributos específicos.

Uma estrutura pode potencialmente dar suporte à preservação de usos de extensão de marcação e reconstituí-los em vez de ProvideValue depender da saída na árvore de objetos para serialização. Nesse caso, as informações são úteis durante a ConstructorArgumentAttribute serialização para produzir uma representação precisa do uso típico da extensão de marcação. Para obter mais informações sobre extensões de marcação, consulte Visão geral das Extensões de Marcação para XAML.

Para ser válido para uma ConstructorArgumentAttribute atribuição, o construtor público sem parâmetros de um tipo deve dar suporte a exatamente um parâmetro. O nome do parâmetro deve corresponder a uma propriedade de leitura/gravação. A propriedade deve ser serializável de outra forma. Você usa esse atributo para criar a correspondência entre o nome do parâmetro no construtor e a propriedade . Especificamente, você aplica esse atributo à definição de nível de propriedade da propriedade de leitura/gravação de conexão.

Os consumidores de ConstructorArgumentAttribute podem gerar casos ArgumentName em que não resolve ao suporte de tipo ou quando aplicado a um tipo que não tem os argumentos de construção e aridade apropriados.

Em versões anteriores do .NET Framework, essa classe existia no assembly específico do WPF WindowsBase. No .NET Framework 4, ConstructorArgumentAttribute está no assembly System.Xaml. Para obter mais informações, consulte Tipos migrados do WPF para o System.Xaml.

Notas de uso do WPF

Para obter mais informações sobre extensões de marcação e WPF, consulte Extensões de marcação e XAML do WPF.

Construtores

ConstructorArgumentAttribute(String)

Inicializa uma nova instância da classe ConstructorArgumentAttribute.

Propriedades

ArgumentName	Obtém o parâmetro de nome do construtor que inicializará a propriedade associada.
TypeId	Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute. (Herdado de Attribute)

Métodos

Equals(Object)	Retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
GetHashCode()	Retorna o código hash para a instância. (Herdado de Attribute)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsDefaultAttribute()	Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada. (Herdado de Attribute)
Match(Object)	Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• MarkupExtension
• Atributos CLR relacionados a XAML para tipos e bibliotecas personalizados
• Definir tipos personalizados para uso com os Serviços XAML do .NET
• Serviços XAML
• Conversores de tipo e extensões de marcação para XAML