ContentPropertyAttribute Classe

Définition

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

Héritage

Object

Attribute

ContentPropertyAttribute

Attributs

AttributeUsageAttribute

Exemples

L’exemple suivant crée une classe nommée Film qui a un ContentPropertyAttribute appliqué. La propriété nommée Title est indiquée en tant que propriété de contenu.

[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

Remarques

Si la propriété associée d’un ContentPropertyAttribute n’est pas de type string ou object, un processeur XAML tente d’identifier une technique de conversion de valeur. La première case activée concerne la conversion de type natif, soit des primitives du langage XAML, soit des conversions natives spécifiques activées par cette implémentation d’enregistreur XAML particulière. L’étape suivante consiste à rechercher un convertisseur de type. Dans les implémentations .NET, un convertisseur de type est identifié en fonction TypeConverterAttribute du niveau membre ou de la définition de niveau de type qui s’applique. Si aucune conversion de valeur ne peut être identifiée, un enregistreur d’objets XAML lève généralement une exception.

Pour accepter plusieurs éléments d’objet en tant que contenu, le type de la propriété de contenu XAML doit être pris en charge en tant que type de collection.

En raison de la Inherited=true déclaration de l’attribut, une valeur pour un ContentPropertyAttribute applique normalement une désignation de propriété de contenu à toutes les classes dérivées. L’application d’un vide ContentPropertyAttribute permet à une classe dérivée de supprimer une déclaration d’un attribut de propriété de contenu par une classe de base (et de noter que la classe n’a pas de propriété de contenu). L’application d’un nom ContentPropertyAttribute différent remplace l’hérité ContentPropertyAttribute par le nouveau.

Dans les versions précédentes du .NET Framework, cette classe existait dans l’assembly WindowsBase spécifique à WPF et avait également une implémentation parallèle dans Windows Communication Foundation (WCF). À partir de .NET Framework 4.0, ContentPropertyAttribute se trouve dans l’assembly System.Xaml. Pour plus d'informations, consultez Types Migrated from WPF to System.Xaml.

Remarques sur l'utilisation de WPF

Exemple d’une classe dans Windows Presentation Foundation (WPF) qui utilise le ContentPropertyAttribute est ContentControl, dont la Button classe hérite. La ContentControl.Content propriété est la propriété de contenu définie par .ContentPropertyAttribute Si un Button est instancié en XAML, le Content de Button sera défini sur l’élément qui se trouve entre les balises de bouton de début et de fin.

Constructeurs

Propriétés

Méthodes

Implémentations d’interfaces explicites

S’applique à

Voir aussi

• Attributs CLR liés à XAML pour les types et bibliothèques personnalisés
• Définir des types personnalisés à utiliser avec les services XAML .NET
• Services XAML