如何为自定义MAUI类定义全局样式？遇XFC0001/XFC0000错误

核心问题分析 #

你遇到的两个错误本质是两个关键点没处理到位：自定义类缺少可绑定属性，以及样式的TargetType和属性引用规则错误。

1. 给自定义类MyClass添加可绑定的TextColor属性 #

Grid本身没有TextColor属性，MAUI的样式只能作用于可绑定属性，所以你必须在MyClass中显式声明这个属性：

public class MyClass : Grid, IDisposable
{
    // 声明TextColor可绑定属性
    public static readonly BindableProperty TextColorProperty =
        BindableProperty.Create(
            nameof(TextColor), 
            typeof(Color), 
            typeof(MyClass), 
            defaultValue: Colors.Black);

    public Color TextColor
    {
        get => (Color)GetValue(TextColorProperty);
        set => SetValue(TextColorProperty, value);
    }

    // 你的IDisposable实现和其他业务代码
    public void Dispose()
    {
        // 资源清理逻辑
    }
}

2. 修正Styles.xaml中的样式写法 #

• TargetType必须用local:前缀指定自定义类型，否则XAML无法识别你的自定义类（对应XFC0000错误）
• 属性名不需要加local:前缀，因为属性属于TargetType指定的类成员（对应XFC0001错误）

正确的样式代码：

<Style TargetType="local:MyClass">
    <Setter Property="TextColor" Value="Blue" />
    <!-- 其他需要设置的属性Setter -->
</Style>

3. 验证命名空间正确性 #

确保xmlns:local指向的命名空间和MyClass实际所在的命名空间完全一致，比如如果MyClass在MyApp.Controls而非MyApp.Views，需要修正命名空间声明：

xmlns:local="clr-namespace:MyApp.Controls"

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