ContentPropertyAttribute Класс

Определение

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

Наследование

Object

Attribute

ContentPropertyAttribute

Атрибуты

AttributeUsageAttribute

Примеры

В следующем примере создается класс с именем Film , который имеет примененный ContentPropertyAttribute . Имя Title свойства указывается как свойство содержимого.

[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

Комментарии

Если связанное свойство ContentPropertyAttribute не имеет типа string или objectобработчик XAML пытается определить метод преобразования значений. Первая проверка заключается в преобразовании машинного типа либо примитивов языка XAML, либо конкретных собственных преобразований, включенных в рамках конкретной реализации модуля записи XAML. Следующий шаг — поиск преобразователя типов. В реализации .NET преобразователь типов определяется на TypeConverterAttribute основе определения уровня члена или типа, применяемого. Если преобразование значений не может быть идентифицировано, модуль записи объектов XAML обычно создает исключение.

Чтобы принять в качестве содержимого несколько элементов объекта, тип свойства содержимого XAML должен поддерживаться как тип коллекции.

Inherited=true Из-за объявления атрибута значение обычно ContentPropertyAttribute применяет обозначение свойства содержимого ко всем производным классам. Применение пустого ContentPropertyAttribute позволяет производной классу удалить объявление атрибута свойства содержимого базовым классом (и отметить, что класс не имеет свойства содержимого). Применение другого именованного ContentPropertyAttribute заменяет унаследованное ContentPropertyAttribute новое.

В предыдущих версиях .NET Framework этот класс существовал в windowsBase для конкретной сборки WPF, а также имел параллельную реализацию в Windows Communication Foundation (WCF). Начиная с .NET Framework 4.0, ContentPropertyAttribute находится в сборке System.Xaml. Дополнительные сведения см. в разделе "Типы, перенесенные из WPF в System.Xaml".

Заметки об использовании WPF

Пример класса в Windows Presentation Foundation (WPF), который используется ContentPropertyAttribute , — ContentControlэто класс, от которого Button наследуется класс. Свойство ContentControl.Content — это свойство содержимого, заданное параметром ContentPropertyAttribute. Button Если экземпляр создается в XAML, ContentButton для элемента будет задан элемент, который находится между тегами кнопки "Пуск" и "Конец".

См. также раздел

• Атрибуты среды CLR, связанные с XAML, для пользовательских типов и библиотек
• Определение настраиваемых типов для использования со службами XAML .NET
• Службы XAML