MAUI新生1.4-XAML语法基础：x命名空间xmlns:x

标签：1.4 代码 xmlns XAML 元素编译类型 public

x命名空间，又叫XAML命名空间，作用于XAML的编译过程。我们知道，XAML代码，最终通过XAML编译器，编译为中间代码IL，并与后台C#代码的编译结果合并。而在编译的过程中，经常需要告诉编译器一些重要信息，比如应该与哪个C#类的编译结果合并、XAML声明的元素是public还是private、元素的变量名是什么......这些可以和XAML编译器沟通的工具，都在x命名空间中。【xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"】，这是引入x命名空间的代码，x是命名空间的别名，也可以使用y或者z等，使用x只是约定俗成的习惯。x命名空间的工具，可以划分为四大类：属性、标记扩展、指令和数据类型。常用的如下所示：

属性，9个：x:Class、x:ClassModifier、x:Name、x:FiledModifier、x:Key、x:Arguments、x:FactoryMethod、x:TypeArguments、x:DataType
标记扩展，4个：x:Array、x:Null、x:Type、x:Static
指令，2个：x:Code、x:XData
类型，14个：x:Byte、x:Int16、x:Int32、x:Int64、x:Single、x:Double、x:Decimal、x:Boolean、x:Char、x:String、x:DateTime、x:TimeSpan、x:Object

一、属性：

1、x:Class。将当前XAML文件的编译结果，与后台代码中的指定类合并。只能作为页面根元素的属性使用，x:Class的值所指向的后台类，必须使用partial关键字且继承自根元素的类型。

//XAML文件的根元素
<ContentPage
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    x:Class="MauiApp7.MainPage"
</ContentPage>

//后台代码，部分类，继承自ContentPage
public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }
}

2、x:ClassModifier。指定当前XAML文件的编译结果类具有怎样的访问级别。必须与对应的后台代码，具有相同的访问级别。

//指定访问级别为public，比较少使用
<ContentPage
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    x:Class="MauiApp7.MainPage"
    x:ClassModifier="public">
</ContentPage>

//后台代码也是public
public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }
}

3、x:Name。XAML元素本质上是对象，在XAML文件中，通过x:Name来指定对象的变量名称。

//将Lable对象，命名为lable
//等效C#代码：var lable = new Lable{Text = "HelloWorld"};
<ContentPage
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    x:Class="MauiApp7.MainPage"

    <StackLayout>
        <Label x:Name="lable" Text="HelloWorld"/>
        <Button Text="ChangeLabelText" Clicked="Button_Clicked"/>
    </StackLayout>
</ContentPage>

//后台代码，点击事件的响应中，使用“lable.Text”引用对象属性，并赋值
public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }
    private void Button_Clicked(object sender, EventArgs e)
    {
        lable.Text = "HiChina";
    }
}

4、x:FieldModifier。XAML文件中，除根元素外，其它元素在C#代码层面，本质上就是字段。类似于x:ClassModifier，前者指定类的访问级别，后者指定字段的访问级别。

//默认为internal，定义为public，这样在其它项目中，也可以访问这个对象
<StackLayout>
    <Label x:Name="lable" x:FieldModifier="public" Text="定义访问级别" />
</StackLayout>

5、x:Key。资源字典是Dictionary<string,object>集合类型，每个集合的项目，都可以使用x:Key来定义键名。其它元素引用这个资源时，通过键名来引用。

//资源字典中，添加键值对字典，键名使用x:Key来定义
//{StaticResource Key=ChinaHi}可以简写为{StaticResource ChinaHi}
//因为Key为StaticResource的内容属性，所以可以省略
<ContentPage
    x:Class="MauiApp7.MainPage"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml">

    <ContentPage.Resources>
        <x:String x:Key="ChinaHi">吃了吗</x:String>
    </ContentPage.Resources>
    <StackLayout>
        <Label
            x:Name="lable"
            x:FieldModifier="public"
            Text="{StaticResource Key=ChinaHi}" />
    </StackLayout>

</ContentPage>

6/7、x:Arguments、x:FactoryMethod。XAML中，每定义一个元素标签，本质上就是创建一个对象。在C#代码层面，创建对象的方式，除了属性赋值外，还有两个方法，一是构造函数初始化；二是工厂函数初始化。通过x:Arguments，可以给构造函数传递参数，而x:FactoryMethod可以调用工厂方法，并结合x:Arguments为工厂方法传递参数。

//Color类定义了多个构造函数和工厂函数，以此为例来说明x:Arguments和x:FactoryMethod的使用
//调用一个参数的构造方法来创建Color对象
<BoxView HeightRequest="100" WidthRequest="100">
    <BoxView.Color>
        <Color>
            <x:Arguments>
                <x:Single>0.8</x:Single>
            </x:Arguments>
        </Color>
    </BoxView.Color>
</BoxView>

//调用三个参数的构造方法来创建Color对象
<BoxView HeightRequest="100" WidthRequest="100">
    <BoxView.Color>
        <Color>
            <x:Arguments>
                <x:Single>0.65</x:Single>
                <x:Single>0.8</x:Single>
                <x:Single>0.75</x:Single>
            </x:Arguments>
        </Color>
    </BoxView.Color>
</BoxView>

//调用工厂函数FromHsla，创建Color对象
<BoxView HeightRequest="150" WidthRequest="150">
    <BoxView.Color>
        <Color x:FactoryMethod="FromHsla">
            <x:Arguments>
                <x:Double>0.23</x:Double>
                <x:Double>0.42</x:Double>
                <x:Double>0.69</x:Double>
                <x:Double>0.7</x:Double>
            </x:Arguments>
        </Color>
    </BoxView.Color>
</BoxView>

8、x:TypeArguments。泛型类型，在实例化时，需要指明泛型参数的类型，x:TypeArguments的主要作用就是指定对象的泛型类型。

//泛型参数为简单类型
//引入List<T>的命名空间xmlns:scg="clr-namespace:System.Collections.Generic;assembly=netstandard"
<CollectionView>
    <CollectionView.ItemsSource>
        <scg:List x:TypeArguments="x:String">
            <x:String>abc</x:String>
            <x:String>efg</x:String>
            <x:String>hij</x:String>
        </scg:List>
    </CollectionView.ItemsSource>
    <CollectionView.ItemTemplate>
        <DataTemplate>
            <Label Text="{Binding}" />
        </DataTemplate>
    </CollectionView.ItemTemplate>
</CollectionView>

//泛型参数为复杂类型
<ContentPage
    x:Class="MauiApp7.MainPage"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:models="clr-namespace:MauiApp7.Models"
    xmlns:scg="clr-namespace:System.Collections.Generic;assembly=netstandard">

    <StackLayout>
        <CollectionView>
            <CollectionView.ItemsSource>
                <scg:List x:TypeArguments="models:Employee">
                    <models:Employee Name="张三" Age="20" />
                    <models:Employee Name="李四" Age="30" />
                    <models:Employee Name="王五" Age="40" />
                </scg:List>
            </CollectionView.ItemsSource>
            <CollectionView.ItemTemplate>
                <DataTemplate>
                    <StackLayout>
                        <Label
                            Grid.Row="0"
                            Grid.Column="1"
                            Text="{Binding Name}" />
                        <Label
                            Grid.Row="1"
                            Grid.Column="1"
                            Text="{Binding Age}" />
                    </StackLayout>
                </DataTemplate>
            </CollectionView.ItemTemplate>
        </CollectionView>
    </StackLayout>

</ContentPage>

9、x:Datatype。XAML的绑定在运行时解析，造成两个问题：一是无法对绑定进行编译时校验，要到运行时才能发现；二是存在性能损耗。x:Datatype的作用，就是在编译时，明确绑定上下文的类型，可以明显改善以上两个问题，称之为编译时绑定。在XAML元素属性上声明x:Datatype后，绑定作用会向下延伸到子元素。所以一般情况下，x:Datatype和BindingContext定义在同一层级的元素上，但也可以在视觉树的任一层级声明。除了和BindingContext一起使用外，x:Datatype还可作用于DataTemplate，使集合绑定也变成编译时。

//BindingContext和x:Datatype都定义在ContentPage元素上
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:local="clr-namespace:DataBindingDemos"
             x:Class="MauiApp7.MainPage"
             x:DataType="local:HslColorViewModel">

    <ContentPage.BindingContext>
        <local:HslColorViewModel Color="Sienna" />
    </ContentPage.BindingContext>


    <StackLayout Margin="10, 0">
        <Label Text="{Binding Name}" />
        <Slider Value="{Binding Hue}" />
        <Label Text="{Binding Hue, StringFormat='Hue = {0:F2}'}" />
        <Slider Value="{Binding Saturation}" />
        <Label Text="{Binding Saturation, StringFormat='Saturation = {0:F2}'}" />
        <Slider Value="{Binding Luminosity}" />
        <Label Text="{Binding Luminosity, StringFormat='Luminosity = {0:F2}'}" />
    </StackLayout> 

</ContentPage>


//在DataTemplate中使用
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:local="clr-namespace:DataBindingDemos"
             x:Class="MauiApp7.MainPage"
             x:DataType="local:HslColorViewModel">

    <Grid>
        <ListView ItemsSource="{x:Static local:NamedColor.All}">
            <ListView.ItemTemplate>
                <DataTemplate x:DataType="local:NamedColor">
                    <ViewCell>
                        <StackLayout Orientation="Horizontal">
                            <BoxView Color="{Binding Color}"/>
                            <Label Text="{Binding FriendlyName}"/>
                        </StackLayout>
                    </ViewCell>
                </DataTemplate>
            </ListView.ItemTemplate>
        </ListView>
    </Grid>    

</ContentPage>

二、标记扩展：详见标记扩展章节

x:Array。将数组赋值给属性
x:Null。将Null值赋值给属性
x:Type。将类型值赋值给属性
x:Static。将静态成员赋值给属性

三、指令

x:Code用于在XAML文档中写C#后台代码，x:XData用于引入XMLDataProvider提供的数据，都很少使用。这些工作，都应该在后台代码中完成，可以略过。

四、类型

定义资源和传递参数时，可以通过x命名空间进行类型申明，如<x:String x:Key="SayHi">HelloWorld</x:String>，等效于C#代码string SayHi = "HelloWorld"。这些类型支持，与.NET支持的基本类型一一对应。我们也可以通过引用.NET的System命名空间，实现同样功能，如<sys:String x:Key="SayHi">HelloWorld</sys:String>。目前x命名空间，提供了13个类型支持，可以分一下组：

整数：x:Byte、x:Int16、x:Int32、x:Int64
浮点数：x:Single（相当于float）、x:Double、x:Decimal
布尔：x:Boolean
字符：x:Char
字符串：x:String
日期时间：x:DateTime、x:TimeSpan
对象：x:Object

//在资源字典中申明类型变量
<ContentPage.Resources>
    <x:String x:Key="eSayHi">How are you!</x:String>
    <x:String x:Key="cSayHi">吃了吗！</x:String>
</ContentPage.Resources>
<Label Text="{StaticResource eSayHi}" />


//为构造函数传递参数
//下例中Color类有多个构造函数重载，根据传入参数，调用不同的构造函数
//使用x:Arguments传递参数
<BoxView HeightRequest="150">
    <BoxView.Color>
        <Color>
            <x:Arguments>
                <x:Single>0.9</x:Single>
            </x:Arguments>
        </Color>
    </BoxView.Color>
</BoxView>
<BoxView HeightRequest="150">
    <BoxView.Color>
        <Color>
            <x:Arguments>
                <x:Single>0.25</x:Single>
                <x:Single>0.5</x:Single>
                <x:Single>0.75</x:Single>
            </x:Arguments>
        </Color>
    </BoxView.Color>
</BoxView>

标签：1.4,代码,xmlns,XAML,元素,编译,类型,public
From： https://www.cnblogs.com/functionMC/p/16901849.html

MAUI新生1.4-XAML语法基础：x命名空间xmlns:x

相关文章

赞助商

阅读排行