ContentPropertyAttribute Clase

Definición

Indica qué propiedad de un tipo es la propiedad de contenido XAML.Indicates which property of a type is the XAML content property. Un procesador XAML usa esta información al procesar elementos secundarios XAML de representaciones XAML del tipo con atributos.A XAML processor uses this information when processing XAML child elements of XAML representations of the attributed type.

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

Ejemplos

En el ejemplo siguiente se crea una Film clase denominada que ContentPropertyAttribute tiene un aplicado.The following example creates a class named Film that has a ContentPropertyAttribute applied. La propiedad denominada Title se indica como la propiedad de contenido.The property named Title is indicated as the content property.

[ContentProperty("Title")]
public class Film
{
    public Film()
    {
    }

    public string Title
    {
        get { return _title; }
        set { _title = value; }
    }

    private string _title;
}
<ContentProperty("Title")>
Public Class Film
    Public Sub New()
    End Sub

    Public Property Title() As String
        Get
            Return _title
        End Get
        Set(ByVal value As String)
            _title = value
        End Set
    End Property

    Private _title As String
End Class

Comentarios

Si la propiedad asociada de una ContentPropertyAttribute clase no es de string tipo objecto, un procesador XAML intenta identificar una técnica de conversión de valores.If the associated property of a ContentPropertyAttribute is not of type string or object, a XAML processor attempts to identify a value conversion technique. La primera comprobación es para la conversión de tipos nativa, ya sea de primitivas del lenguaje XAML o de conversiones nativas específicas habilitadas por esa implementación de escritor XAML concreta.The first check is for native type conversion, either of the XAML language primitives or of specific native conversions enabled by that particular XAML writer implementation. El siguiente paso consiste en buscar un convertidor de tipos.The next step is to look for a type converter. En las implementaciones de .net, se identifica un convertidor de tipos TypeConverterAttribute basándose en en el nivel de miembro o en la definición de nivel de tipo que se aplica.In the .NET implementations, a type converter is identified based on TypeConverterAttribute on either the member level or type level definition that applies. Si no se puede identificar ninguna conversión de valor, un escritor de objetos XAML suele producir una excepción.If no value conversion can be identified, a XAML object writer typically throws an exception.

Para aceptar más de un elemento de objeto único como contenido, el tipo de la propiedad de contenido XAML debe ser compatible como un tipo de colección.In order to accept more than a single object element as content, the type of the XAML content property must be supportable as a collection type.

Debido a la Inherited=true declaración del atributo, un valor ContentPropertyAttribute para normalmente aplica también una designación de propiedad de contenido a todas las clases derivadas.Because of the Inherited=true declaration of the attribute, a value for a ContentPropertyAttribute normally applies a content property designation to all derived classes as well. Aplicar un vacío ContentPropertyAttribute permite a una clase derivada quitar una declaración de un atributo de propiedad de contenido por parte de una clase base (y tener en cuenta que la clase no tiene ninguna propiedad de contenido).Applying an empty ContentPropertyAttribute enables a derived class to remove a declaration of a content property attribute by a base class (and to note that the class has no content property). Al aplicar un con ContentPropertyAttribute un nombre diferente ContentPropertyAttribute , se reemplaza el heredado por el nuevo.Applying a differently named ContentPropertyAttribute replaces the inherited ContentPropertyAttribute with the new one.

En versiones anteriores de la .NET Framework, esta clase existía en el ensamblado específico de WPF, y también tenía una implementación paralela en Windows Communication Foundation (WCF).In previous versions of the .NET Framework, this class existed in the WPF-specific assembly WindowsBase, and also had a parallel implementation in Windows Communication Foundation (WCF). A partir de la .NET Framework 4,0 ContentPropertyAttribute , está en el ensamblado System. Xaml.Starting with the .NET Framework 4.0, ContentPropertyAttribute 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

Un ejemplo de una clase en Windows Presentation Foundation (WPF) que usa ContentPropertyAttribute es ContentControl, que la Button clase hereda de.An example of a class in Windows Presentation Foundation (WPF) that uses the ContentPropertyAttribute is ContentControl, which the Button class inherits from. La ContentControl.Content propiedad es la propiedad de contenido establecida ContentPropertyAttributepor.The ContentControl.Content property is the content property set by the ContentPropertyAttribute. Si se Button crea una instancia de en XAML, Content el de Button se establecerá en el elemento que se encuentra entre las etiquetas del botón Inicio y el final.If a Button is instantiated in XAML, the Content of the Button will be set to the element that is between the start and end button tags.

Constructores

ContentPropertyAttribute()

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

ContentPropertyAttribute(String)

Inicializa una instancia nueva de la clase ContentPropertyAttribute con el nombre especificado.Initializes a new instance of the ContentPropertyAttribute class, by using the specified name.

Propiedades

Name

Obtiene el nombre de la propiedad que es la propiedad de contenido.Gets the name of the property that is the content 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 objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Devuelve una cadena 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: