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

Nell'esempio seguente viene creata una classe Film denominata a cui ContentPropertyAttribute è applicato un oggetto.The following example creates a class named Film that has a ContentPropertyAttribute applied. La proprietà denominata Title è indicata 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 oggetto non è di string tipo objecto, un processore XAML tenta di identificare una tecnica di conversione dei 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 è per la conversione di tipi nativi, una delle primitive del linguaggio XAML o delle conversioni native specifiche abilitate da tale 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 TypeConverterAttribute base al livello di membro o alla definizione del livello del tipo applicabile.In the .NET implementations, a type converter is identified based on TypeConverterAttribute on either the member level or type level definition that applies. Se non è possibile identificare alcuna conversione del valore, un writer di oggetti XAML genera in genere un'eccezione.If no value conversion can be identified, a XAML object writer typically throws an exception.

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

A causa della Inherited=true dichiarazione dell'attributo, un valore per un oggetto ContentPropertyAttribute applica normalmente una designazione della proprietà del contenuto 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. L'applicazione di ContentPropertyAttribute un oggetto vuoto consente a una classe derivata di rimuovere una dichiarazione di un attributo di proprietà del contenuto da parte di una classe di base (e di notare che la classe non dispone di alcuna proprietà di 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). L'applicazione di un ContentPropertyAttribute nome diverso sostituisce ContentPropertyAttribute l'oggetto ereditato con quello nuovo.Applying a differently named ContentPropertyAttribute replaces the inherited ContentPropertyAttribute with the new one.

Nelle versioni precedenti del .NET Framework, questa classe era presente nell'assembly WindowsBase specifico di WPF e aveva 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 si trova 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 di WPFWPF Usage Notes

Un esempio di classe in Windows Presentation Foundation (WPF) che utilizza ContentPropertyAttribute è ContentControl, da cui la 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. La ContentControl.Content proprietà è la proprietà ContentPropertyAttributedi contenuto impostata da.The ContentControl.Content property is the content property set by the ContentPropertyAttribute. Se viene Button creata un'istanza di un oggetto in Content XAML, Button l'oggetto di verrà impostato sull'elemento compreso tra i tag dei pulsanti di inizio e di fine.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