MAUI中使用<Span>格式化Label文本时遇异常及样式继承问题

解决InvalidCastException报错 #

你遇到的Object must implement IConvertible错误，本质是因为Span和Label的Style目标类型不兼容，直接给Span应用Label的Style或者错误的属性绑定方式会触发类型转换失败。要避免这个问题，不要直接复用Label的Style，而是针对Span单独设置属性或定义专属样式。

单个单词加粗的最简实现 #

如果只是需要实现单个单词加粗，直接给目标Span设置FontAttributes="Bold"即可，基础写法不会报错：

<Label FontSize="16" TextColor="#333" FontFamily="SegoeUI">
    <Label.FormattedText>
        <FormattedString>
            <Span Text="这是一段 "/>
            <Span Text="加粗的单词" FontAttributes="Bold"/>
            <Span Text=" 示例文本"/>
        </FormattedString>
    </Label.FormattedText>
</Label>

让Span继承Label的样式属性 #

如果需要Span继承父Label的FontSize、TextColor、FontFamily等样式，可以用以下两种方法：

方法1：绑定父Label的属性 #

通过x:Reference绑定父Label的对应属性，让Span同步继承：

<Label x:Name="MainLabel" FontSize="18" TextColor="#222" FontFamily="MicrosoftYaHei">
    <Label.FormattedText>
        <FormattedString>
            <Span Text="继承父Label样式的文本"
                  FontSize="{Binding Source={x:Reference MainLabel}, Path=FontSize}"
                  TextColor="{Binding Source={x:Reference MainLabel}, Path=TextColor}"
                  FontFamily="{Binding Source={x:Reference MainLabel}, Path=FontFamily}"/>
            <Span Text=" 加粗内容" FontAttributes="Bold"
                  FontSize="{Binding Source={x:Reference MainLabel}, Path=FontSize}"
                  TextColor="{Binding Source={x:Reference MainLabel}, Path=TextColor}"
                  FontFamily="{Binding Source={x:Reference MainLabel}, Path=FontFamily}"/>
        </FormattedString>
    </Label.FormattedText>
</Label>

方法2：定义Span的全局隐式样式 #

在页面或App的ResourceDictionary中定义Span的隐式样式，统一复用Label的默认样式资源：

<ContentPage.Resources>
    <Style TargetType="Span">
        <Setter Property="FontSize" Value="{DynamicResource DefaultFontSize}"/>
        <Setter Property="TextColor" Value="{DynamicResource DefaultTextColor}"/>
        <Setter Property="FontFamily" Value="{DynamicResource DefaultFontFamily}"/>
    </Style>
</ContentPage.Resources>

<!-- 使用时只需设置特殊属性 -->
<Label>
    <Label.FormattedText>
        <FormattedString>
            <Span Text="默认样式文本"/>
            <Span Text=" 加粗文本" FontAttributes="Bold"/>
        </FormattedString>
    </Label.FormattedText>
</Label>

额外注意事项 #

• 永远不要将Label的Style直接赋值给Span的Style属性，两者的目标类型不同，强制转换必然报错。
• 绑定属性时确保源属性的类型与Span的目标属性类型匹配，比如FontFamily必须是字符串类型的字体名称，不能绑定到Label的Style对象。

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