ContentPropertyAttribute Clase

Definición

public ref class ContentPropertyAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=true)]
public sealed class ContentPropertyAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=true)>]
type ContentPropertyAttribute = class
    inherit Attribute

Public NotInheritable Class ContentPropertyAttribute
Inherits Attribute

Herencia

Object

Attribute

ContentPropertyAttribute

Atributos

AttributeUsageAttribute

Ejemplos

En el ejemplo siguiente se crea una clase denominada Film que tiene aplicado.ContentPropertyAttribute La propiedad denominada Title se indica como la propiedad content.

[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 un ContentPropertyAttribute no es de tipo string o object, un procesador XAML intenta identificar una técnica de conversión de valores. La primera comprobación es para la conversión de tipos nativos, ya sea de los primitivos del lenguaje XAML o de conversiones nativas específicas habilitadas por esa implementación concreta del escritor XAML. El siguiente paso es buscar un convertidor de tipos. En las implementaciones de .NET, se identifica un convertidor de tipos basado en TypeConverterAttribute la definición de nivel de miembro o de tipo que se aplica. Si no se puede identificar ninguna conversión de valor, un escritor de objetos XAML normalmente produce una excepción.

Para aceptar más de un único elemento de objeto como contenido, el tipo de la propiedad de contenido XAML debe ser compatible como un tipo de colección.

Debido a la Inherited=true declaración del atributo , un valor para un normalmente ContentPropertyAttribute aplica una designación de propiedad de contenido a todas las clases derivadas. La aplicación de una clase vacía ContentPropertyAttribute permite que una clase derivada quite una declaración de un atributo de propiedad de contenido por una clase base (y tenga en cuenta que la clase no tiene ninguna propiedad de contenido). Al aplicar un nombre ContentPropertyAttribute diferente, se reemplaza el heredado ContentPropertyAttribute por el nuevo.

En versiones anteriores de .NET Framework, esta clase existía en el ensamblado específico de WPF WindowsBase y también tenía una implementación paralela en Windows Communication Foundation (WCF). A partir de .NET Framework 4.0, ContentPropertyAttribute se encuentra en el ensamblado System.Xaml. Para obtener más información, consulta Types Migrated from WPF to System.Xaml.

Notas de uso de WPF

Un ejemplo de una clase en Windows Presentation Foundation (WPF) que usa ContentPropertyAttribute es ContentControl, de la que hereda la Button clase . La ContentControl.Content propiedad es la propiedad de contenido establecida por .ContentPropertyAttribute Si se crea una Button instancia de en XAML, el Content de Button se establecerá en el elemento que se encuentra entre las etiquetas del botón de inicio y finalización.

Constructores

Propiedades

Métodos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

• Atributos de CLR relacionados con XAML para los tipos y bibliotecas personalizados
• Definición de tipos personalizados para usarlos con los servicios XAML de .NET
• Servicios XAML