ContentPropertyAttribute ContentPropertyAttribute ContentPropertyAttribute ContentPropertyAttribute Class

Definizione

Indica quale proprietà di un tipo è la proprietà di contenuto XAML.Indicates which property of a type is the XAML content property. Un processore XAML usa queste informazioni durante l'elaborazione degli elementi figlio XAML delle rappresentazioni XAML del tipo con attributo.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
Ereditarietà
ContentPropertyAttributeContentPropertyAttributeContentPropertyAttributeContentPropertyAttribute
Attributi

Esempi

L'esempio seguente crea una classe denominata Film che ha un ContentPropertyAttribute applicato.The following example creates a class named Film that has a ContentPropertyAttribute applied. La proprietà denominata Title è indicato come proprietà di contenuto.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

Commenti

Se la proprietà associata di un ContentPropertyAttribute non è di tipo string o object, un processore XAML tenta di identificare una tecnica di conversione di valori.If the associated property of a ContentPropertyAttribute is not of type string or object, a XAML processor attempts to identify a value conversion technique. Il primo controllo sia per la conversione di tipo nativo, le primitive di linguaggio XAML di o delle conversioni native specifiche abilitate per quel particolare implementazione del writer XAML.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. Il passaggio successivo consiste nel cercare un convertitore di tipi.The next step is to look for a type converter. Nelle implementazioni di .NET, un convertitore di tipi viene identificato in base TypeConverterAttribute in una definizione del membro livello o tipo di livello che si applica.In the .NET implementations, a type converter is identified based on TypeConverterAttribute on either the member level or type level definition that applies. Se la conversione non può essere identificata, un writer di oggetti XAML in genere genera un'eccezione.If no value conversion can be identified, a XAML object writer typically throws an exception.

Per accettare più di un elemento oggetto singolo come contenuto, il tipo della proprietà di contenuto XAML deve essere compatibile come tipo di raccolta.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.

Perché il Inherited=true dichiarazione dell'attributo, un valore per un ContentPropertyAttribute normalmente una designazione di proprietà di contenuto si applica a tutte le classi derivate.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. Applicazione vuota ContentPropertyAttribute consente a una classe derivata per rimuovere una dichiarazione di un attributo di proprietà di contenuto da una classe di base (e notare che la classe non dispone di alcuna proprietà del contenuto).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). Applicazione di un nome diverso ContentPropertyAttribute sostituisce ereditato ContentPropertyAttribute con quello nuovo.Applying a differently named ContentPropertyAttribute replaces the inherited ContentPropertyAttribute with the new one.

Nelle versioni precedenti di .NET Framework, questa classe nell'assembly WindowsBase di specifiche di WPF esistenti e presenta anche un'implementazione parallela in 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 partire da .NET Framework 4.0, ContentPropertyAttribute è incluso nell'assembly System. Xaml.Starting with the .NET Framework 4.0, ContentPropertyAttribute is in the System.Xaml assembly. Per altre informazioni, vedere Types Migrated from WPF to System.Xaml.For more information, see Types Migrated from WPF to System.Xaml.

Note sull'utilizzo WPFWPF Usage Notes

Un esempio di una classe in Windows Presentation Foundation (WPF) che usa il ContentPropertyAttribute viene ContentControl, ovvero il Button classe eredita da.An example of a class in Windows Presentation Foundation (WPF) that uses the ContentPropertyAttribute is ContentControl, which the Button class inherits from. Il ContentControl.Content è la proprietà di contenuto impostata dal ContentPropertyAttribute.The ContentControl.Content property is the content property set by the ContentPropertyAttribute. Se un Button viene creata un'istanza in XAML, il Content del Button verrà impostato l'elemento che si trova tra i tag di inizio e fine pulsante.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.

Costruttori

ContentPropertyAttribute() ContentPropertyAttribute() ContentPropertyAttribute() ContentPropertyAttribute()

Inizializza una nuova istanza della classe ContentPropertyAttribute.Initializes a new instance of the ContentPropertyAttribute class.

ContentPropertyAttribute(String) ContentPropertyAttribute(String) ContentPropertyAttribute(String) ContentPropertyAttribute(String)

Inizializza una nuova istanza della classe ContentPropertyAttribute usando il nome specificato.Initializes a new instance of the ContentPropertyAttribute class, by using the specified name.

Proprietà

Name Name Name Name

Ottiene il nome della proprietà che è la proprietà di contenuto.Gets the name of the property that is the content property.

TypeId TypeId TypeId TypeId

Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Metodi

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Restituisce il codice hash per l'istanza.Returns the hash code for this instance.

(Inherited from Attribute)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object) Match(Object) Match(Object) Match(Object)

Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Implementazioni dell'interfaccia esplicita

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

Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso a proprietà e metodi esposti da un oggetto.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Si applica a

Vedi anche