WPF自定义控件绑定报错：Binding无法转换为System.String类型

Object of type 'System.Windows.Data.Binding' cannot be converted to type 'System.String'.

报错的直接诱因是依赖属性变更回调中的错误冗余代码，另有几处不规范实现会加剧绑定异常：

1. WPF依赖属性系统在触发值变更回调时，已经完成了属性赋值操作，你在OnValueChangedText中再次手动给InputText赋值，会直接打断绑定初始化流程，让XAML解析器无法识别这是合法的依赖属性绑定操作，转而尝试将Binding对象直接转为String类型触发报错，同时这行代码还会引发无限递归回调的风险。
2. 控件内部用ElementName绑定自身的写法稳定性差，容易受命名冲突、可视化树构建顺序影响出现源查找失败。
3. 文本输入类依赖属性没有显式配置双向绑定、实时更新的元数据，后续会出现输入内容无法实时同步到外部绑定源的问题。

按以下步骤修改代码即可正常使用标准绑定机制：

1. 删除OnValueChangedText回调中的冗余赋值代码，仅保留值变化后需要执行的自定义逻辑即可；同时按照WPF规范修正依赖属性定义，显式配置双向绑定、实时更新参数。
   修正后的UserControl.xaml.cs关键代码：

   public CustomTextBox()
   {
       InitializeComponent();
   }
   
   // 依赖属性字段需遵循WPF命名约定，以Property结尾，避免模板、样式识别异常
   public static readonly DependencyProperty InputTextProperty = DependencyProperty.Register(
           nameof(InputText),
           typeof(string),
           typeof(CustomTextBox),
           new FrameworkPropertyMetadata(
               default(string),
               FrameworkPropertyMetadataOptions.BindsTwoWayByDefault,
               OnValueChangedText,
               null,
               false,
               UpdateSourceTrigger.PropertyChanged)
           );
   
   public static readonly DependencyProperty PlaceHolderProperty = DependencyProperty.Register(nameof(PlaceHolder), typeof(string),
           typeof(CustomTextBox),
           new PropertyMetadata(null));
   
   public string InputText
   {
       get { return (string)GetValue(InputTextProperty); }
       set { SetValue(InputTextProperty, value); }
   }
   public string PlaceHolder
   {
       get { return (string)GetValue(PlaceHolderProperty); }
       set { SetValue(PlaceHolderProperty, value); }
   }
   
   private static void OnValueChangedText(DependencyObject sender,DependencyPropertyChangedEventArgs e)
   {
       // 此处仅编写输入值变化后需要触发的自定义业务逻辑即可，禁止重复给InputText赋值
   }
   

2. 修改控件内部绑定写法，用RelativeSource替代ElementName查找控件自身作为绑定源，规避可视化树构建、命名冲突导致的绑定异常。
   修正后的UserControl.xaml关键代码：

   <TextBox VerticalAlignment="Stretch"
            VerticalContentAlignment="Center"
            HorizontalAlignment="Stretch"
            Background="Transparent"
            x:Name="TextBox"
            TextWrapping="Wrap"
            BorderThickness="0"
            Foreground="Gray"
            CaretBrush="Gray"
            Margin="8,0,0,0"
            Text="{Binding Path=InputText, RelativeSource={RelativeSource AncestorType=local:CustomTextBox}, UpdateSourceTrigger=PropertyChanged}">
   </TextBox>
   
   <TextBlock IsHitTestVisible="False"
              Text="{Binding Path=PlaceHolder, RelativeSource={RelativeSource AncestorType=local:CustomTextBox}}"
              VerticalAlignment="Center"
              HorizontalAlignment="Left"
              Margin="10,0,0,0"
              Foreground="DarkGray">
       <TextBlock.Style>
           <Style TargetType="TextBlock">
               <Setter Property="Visibility" Value="Collapsed"/>
               <Style.Triggers>
                   <DataTrigger Binding="{Binding Text, ElementName=TextBox}" Value="">
                       <Setter Property="Visibility" Value="Visible"/>
                   </DataTrigger>
               </Style.Triggers>
           </Style>
       </TextBlock.Style>
   </TextBlock>
   

3. 确认MainWindow的DataContext已正确赋值为持有UserName属性的ViewModel实例，外部调用的绑定代码无需修改即可正常工作：

   <customcontrols:CustomTextBox InputText="{Binding UserName}"
                                 PlaceHolder="UserName"
                                 Margin="0,0,0,20" />
   

• 不要在自定义UserControl的构造函数或XAML根节点设置DataContext = this，该操作会打断DataContext继承链路，导致外部绑定无法找到上层ViewModel的属性。
• 依赖属性的CLR包装块（即get/set代码段）只能写GetValue和SetValue逻辑，不要添加额外自定义逻辑——WPF绑定引擎运行时会直接调用GetValue/SetValue方法，不会走CLR属性的get/set块，写在里面的逻辑不会被绑定流程触发。

内容的提问来源于stack exchange，提问作者DanielB