ConstructorArgumentAttribute Clase

Definición

Especifica que un objeto se puede inicializar usando una sintaxis de constructor sin parámetros y que una propiedad del nombre especificado proporciona información de construcción.Specifies that an object can be initialized by using a non-parameterless constructor syntax, and that a property of the specified name supplies construction information. Esta información sirve principalmente para la serialización XAML.This information is primarily for XAML serialization.

public ref class ConstructorArgumentAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Property, AllowMultiple=false, Inherited=false)]
public sealed class ConstructorArgumentAttribute : Attribute
type ConstructorArgumentAttribute = class
    inherit Attribute
Public NotInheritable Class ConstructorArgumentAttribute
Inherits Attribute
Herencia
ConstructorArgumentAttribute
Atributos

Comentarios

Este atributo especifica que un parámetro de constructor puede inicializar la propiedad asociada y debe omitirse para la serialización XAML si el constructor se utiliza para construir la instancia.This attribute specifies that the associated property can be initialized by a constructor parameter and should be ignored for XAML serialization if the constructor is used to construct the instance. Esto proporciona mejores representaciones de ida y vuelta para la sintaxis de constructor con parámetros en lugar de la creación de instancias de constructor sin parámetros y atributos específicos.This provides better round trip representations for parameterized constructor syntax rather than parameterless constructor instantiation plus specific attributes.

Un marco de trabajo puede permitir potencialmente conservar los usos de la extensión de marcado y reconstituirlos ProvideValue en lugar de depender de la salida en el árbol de objetos para la serialización.A framework can potentially support preserving markup extension usages and reconstituting them rather than relying on ProvideValue output in the object tree for serialization. En este caso, la ConstructorArgumentAttribute información es útil durante la serialización para generar una representación precisa del uso típico de la extensión de marcado.In this case, the ConstructorArgumentAttribute information is useful during serialization for producing an accurate representation of the typical markup extension usage. Para más información sobre las extensiones de marcado, vea Markup Extensions for XAML Overview.For more information about markup extensions, see Markup Extensions for XAML Overview.

Para ser válido para una ConstructorArgumentAttribute atribución, el constructor público sin parámetros de un tipo debe admitir exactamente un parámetro.In order to be valid for a ConstructorArgumentAttribute attribution, a type's public non-parameterless constructor must support exactly one parameter. El nombre del parámetro debe corresponder a una propiedad de lectura y escritura.The name of the parameter must correspond to a read/write property. De lo contrario, la propiedad debe ser serializable.The property must be otherwise serializable. Este atributo se usa para crear la correspondencia entre el nombre del parámetro en el constructor y la propiedad.You use this attribute to create the correspondence between the name of the parameter in the constructor, and the property. En concreto, aplique este atributo a la definición de nivel de propiedad de la propiedad de lectura/escritura de conexión.Specifically, you apply this attribute to the property-level definition of the connecting read/write property.

Los consumidores ConstructorArgumentAttribute de pueden iniciar en los ArgumentName casos en los que no se resuelve para el tipo de respaldo, o cuando se aplican a un tipo que no tiene los argumentos de construcción y aridad adecuados.Consumers of ConstructorArgumentAttribute may throw in cases where ArgumentName does not resolve to type backing, or when applied to a type that does not have the appropriate construction arguments and arity.

En las versiones anteriores de la .NET Framework, esta clase existía en el ensamblado específico de WPF WindowsBase.In previous versions of the .NET Framework, this class existed in the WPF-specific assembly WindowsBase. En .NET Framework 4.NET Framework 4 ,ConstructorArgumentAttribute está en el ensamblado System. Xaml.In .NET Framework 4.NET Framework 4, ConstructorArgumentAttribute is in the System.Xaml assembly. Para obtener más información, consulta Types Migrated from WPF to System.Xaml.For more information, see Types Migrated from WPF to System.Xaml.

Notas de uso de WPFWPF Usage Notes

Para obtener más información sobre las extensiones de marcado y WPF, vea extensiones de marcado y XAML de WPF.For more information about markup extensions and WPF, see Markup Extensions and WPF XAML.

Constructores

ConstructorArgumentAttribute(String)

Inicializa una nueva instancia de la clase ConstructorArgumentAttribute.Initializes a new instance of the ConstructorArgumentAttribute class.

Propiedades

ArgumentName

Obtiene el parámetro de nombre del constructor que inicializará la propiedad asociada.Gets the name parameter of the constructor that will initialize the associated property.

TypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Heredado de Attribute)

Métodos

Equals(Object)

Devuelve un valor que indica si esta instancia es igual que un objeto especificado.Returns a value that indicates whether this instance is equal to a specified object.

(Heredado de Attribute)
GetHashCode()

Devuelve el código hash de esta instancia.Returns the hash code for this instance.

(Heredado de Attribute)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
IsDefaultAttribute()

Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Heredado de Attribute)
Match(Object)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Heredado de Attribute)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Implementaciones de interfaz explícitas

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.Maps a set of names to a corresponding set of dispatch identifiers.

(Heredado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Heredado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Heredado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acceso a las propiedades y los métodos expuestos por un objeto.Provides access to properties and methods exposed by an object.

(Heredado de Attribute)

Se aplica a

Consulte también: