只能在 DependencyObject 的 DependencyProperty 上设置“绑定”

Question

从一个基于TextBox的自定义控件，我创建了一个名为Items的属性，这样：

public class NewTextBox : TextBox
{
    public ItemCollection Items { get; set; }
}

在 XAML 中使用自定义控件时，我无法绑定该属性，因为它会引发异常“A 'Binding' can only be set on a DependencyProperty of a DependencyObject。”。

如何解决这个异常？

Answer 1

另外值得注意的是，如果您在对象之间复制和粘贴而忘记更改第二个 typeof(Object) 语句，则会收到这些绑定错误。

一小时后我都想不通为什么会出现这个错误，因为一切似乎都已定义且正确。当我想从一个集合变成一个列表时，我将我的属性移动到了一个用户控件中。因此：

public static readonly DependencyProperty FoldersProperty = DependencyProperty
    .Register("Folders", typeof(OutlookFolders), typeof(MainWindow),
    new FrameworkPropertyMetadata(new OutlookFolders()));

public OutlookFolders Folders
{
    get { return GetValue(FoldersProperty) as OutlookFolders; }
    set { SetValue(FoldersProperty, value); }
}

应该变成：

public static readonly DependencyProperty FoldersProperty = DependencyProperty
    .Register("Folders", typeof(OutlookFolders), typeof(SavedFolderControl), 
    new FrameworkPropertyMetadata(new OutlookFolders()));

public OutlookFolders Folders
{
    get { return GetValue(FoldersProperty) as OutlookFolders; }
    set { SetValue(FoldersProperty, value); }
}

在我进行此更改之前，我一直收到错误消息： A 'Binding' cannot be set on the property 'Folders' of type 'SavedFolderControl'. A 'Binding' can only be set on a DependencyProperty of a DependencyObject.

Answer 2

要解决此异常，您需要更改属性Items 并添加一个DependencyProperty，它将在XAML 中用作“链接”。课程将是：

public class AutocompleteTextBox : TextBox
{
    public ItemCollection Items
    {
        get {
            return (ItemCollection)GetValue(ItemsProperty); }
        set {
            SetValue(ItemsProperty, value); }
    }

    public static readonly DependencyProperty ItemsProperty =
        DependencyProperty.Register(
            "Items",
            typeof(ItemCollection),
            typeof(AutocompleteTextBox),
            new PropertyMetadata(default(ItemCollection), OnItemsPropertyChanged));

    private static void OnItemsPropertyChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
    {
        // AutocompleteTextBox source = d as AutocompleteTextBox;
        // Do something...
    }

Answer 3

这里还有一个问题：确保DependencyProperty.Register() 的第一个参数中的字符串与相关属性的名称匹配。

public static readonly DependencyProperty ItemsProperty =
    DependencyProperty.Register(
        "TheItems", // This is wrong
        typeof(ItemCollection),
        typeof(AutocompleteTextBox),
        new PropertyMetadata(default(ItemCollection), OnItemsPropertyChanged));

我在不更改字符串的情况下重命名属性时遇到了这个问题。

Answer 4

我注意到但我不确定是否在任何地方提到的一件事是，您的 DependencyProperty 的名称必须匹配您的属性名称

如果您的属性名称是Items，那么您DependencyProperty 必须是ItemsProperty

在我的情况下，一旦我匹配它们，错误就消失了

Answer 5

另一个可能的原因是您为元数据中的默认值提供了错误的类型。
例如：

new PropertyMetadata(default(ItemCollection), OnItemsPropertyChanged)

如果你改写会抛出这个错误：

new PropertyMetadata(false, OnItemsPropertyChanged)

如果您从代码源复制和粘贴，也会发生这种情况。

Answer 6

我收到了（运行时 + 设计时）消息：

未处理的类型异常 'System.Windows.Markup.XamlParseException' 发生在 PresentationFramework.dll

附加信息：不能在“属性”上设置“绑定” “触发器”类型的属性。 “绑定”只能设置在 DependencyObject 的 DependencyProperty。

我足够聪明，可以在 VM 属性上定义触发器。

// incorrect.. cannot have Trigger for VM property
<Trigger Property="{Binding IsExpanded}" Value="True">
  <Setter Property="Visibility" Value="Visible"/>
</Trigger>

当然应该是数据触发器（使用绑定而不是属性）

<DataTrigger Binding="{Binding IsExpanded}" Value="True">
  <Setter Property="Visibility" Value="Visible"/>
</DataTrigger>

触发器通常用于控件（按钮、文本框、框架元素等）属性。

Answer 7

由于我缺乏监督，我遇到了这个问题。我写了

<Button.Visibility>
   <MultiBinding Converter="{StaticResource mvbConverter}">
     <Binding Path="{Binding isActive}" />
     <Binding Path="{Binding isCashTransaction}" />
   </MultiBinding>
</Button.Visibility>

什么时候我应该写

<Button.Visibility>
   <MultiBinding Converter="{StaticResource mvbConverter}">
     <Binding Path="isActive" />
     <Binding Path="isCashTransaction" />
   </MultiBinding>
</Button.Visibility>