ジェネリック

.NET マルチプラットフォーム アプリ UI (.NET MAUI) XAML では、ジェネリック制約を型引数として指定することで、ジェネリック CLR 型を使用できます。 このサポートは、ジェネリックの制約型引数をジェネリック型のコンストラクターに渡す x:TypeArguments ディレクティブによって提供されます。

型引数は文字列として指定され、通常、sys:String や sys:Int32など、プレフィックスが付けられます。 CLR ジェネリック制約の一般的な型は、既定の .NET MAUI 名前空間にマップされていないライブラリから取得されるため、プレフィックスが必要です。 ただし、x:String や x:Int32などの XAML 2009 組み込み型は型引数としても指定できます。ここで、x は XAML 2009 の XAML 言語名前空間です。 XAML 2009 組み込み型の詳細については、「XAML 2009 Language Primitives」を参照してください。

大事な

x:TypeArguments ディレクティブを使用した .NET MAUI XAML でのジェネリック型の定義はサポートされていません。

コンマ区切り記号を使用して、複数の型引数を指定できます。 さらに、ジェネリック制約でジェネリック型を使用する場合は、入れ子になった制約型引数をかっこで囲む必要があります。

手記

x:Type マークアップ拡張機能は、ジェネリック型の共通言語ランタイム (CLR) 型参照を提供し、C# の typeof 演算子と同様の関数を持ちます。 詳細については、「x:Type マークアップ拡張 を参照してください。

.NET MAUI XAML でジェネリック型を指定し、x:DataType ディレクティブと x:Type ディレクティブを使用する方法については、「ジェネリック型の を指定するバインドをコンパイルする」および「x:Type マークアップ拡張 を参照してください。

単一プリミティブ型引数

x:TypeArguments ディレクティブを使用して、単一のプリミティブ型引数をプレフィックス付き文字列引数として指定できます。

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:scg="clr-namespace:System.Collections.Generic;assembly=netstandard"
             ...>
    <CollectionView>
        <CollectionView.ItemsSource>
            <scg:List x:TypeArguments="x:String">
                <x:String>Baboon</x:String>
                <x:String>Capuchin Monkey</x:String>
                <x:String>Blue Monkey</x:String>
                <x:String>Squirrel Monkey</x:String>
                <x:String>Golden Lion Tamarin</x:String>
                <x:String>Howler Monkey</x:String>
                <x:String>Japanese Macaque</x:String>
            </scg:List>
        </CollectionView.ItemsSource>
    </CollectionView>
</ContentPage>

この例では、System.Collections.Generic は scg XAML 名前空間として定義されています。 CollectionView.ItemsSource プロパティは、XAML 2009 組み込みの x:String 型を使用して、string 型引数でインスタンス化された List<T> に設定されます。 List<string> コレクションは、複数の string 項目で初期化されます。

または、CLR String 型を使用して、List<T> コレクションをインスタンス化することもできます。

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:scg="clr-namespace:System.Collections.Generic;assembly=netstandard"
             xmlns:sys="clr-namespace:System;assembly=netstandard"
             ...>
    <CollectionView>
        <CollectionView.ItemsSource>
            <scg:List x:TypeArguments="sys:String">
                <sys:String>Baboon</sys:String>
                <sys:String>Capuchin Monkey</sys:String>
                <sys:String>Blue Monkey</sys:String>
                <sys:String>Squirrel Monkey</sys:String>
                <sys:String>Golden Lion Tamarin</sys:String>
                <sys:String>Howler Monkey</sys:String>
                <sys:String>Japanese Macaque</sys:String>
            </scg:List>
        </CollectionView.ItemsSource>
    </CollectionView>
</ContentPage>

単一オブジェクト型引数

x:TypeArguments ディレクティブを使用して、プレフィックス付き文字列引数として 1 つのオブジェクト型引数を指定できます。

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:models="clr-namespace:GenericsDemo.Models"
             xmlns:scg="clr-namespace:System.Collections.Generic;assembly=netstandard"
             ...>
    <CollectionView>
        <CollectionView.ItemsSource>
            <scg:List x:TypeArguments="models:Monkey">
                <models:Monkey Name="Baboon"
                               Location="Africa and Asia"
                               ImageUrl="https://upload.wikimedia.org/wikipedia/commons/thumb/f/fc/Papio_anubis_%28Serengeti%2C_2009%29.jpg/200px-Papio_anubis_%28Serengeti%2C_2009%29.jpg" />
                <models:Monkey Name="Capuchin Monkey"
                               Location="Central and South America"
                               ImageUrl="https://upload.wikimedia.org/wikipedia/commons/thumb/4/40/Capuchin_Costa_Rica.jpg/200px-Capuchin_Costa_Rica.jpg" />
                <models:Monkey Name="Blue Monkey"
                               Location="Central and East Africa"
                               ImageUrl="https://upload.wikimedia.org/wikipedia/commons/thumb/8/83/BlueMonkey.jpg/220px-BlueMonkey.jpg" />
            </scg:List>
        </CollectionView.ItemsSource>
        <CollectionView.ItemTemplate>
            <DataTemplate>
                <Grid Padding="10">
                    <Grid.RowDefinitions>
                        <RowDefinition Height="Auto" />
                        <RowDefinition Height="Auto" />
                    </Grid.RowDefinitions>
                    <Grid.ColumnDefinitions>
                        <ColumnDefinition Width="Auto" />
                        <ColumnDefinition Width="Auto" />
                    </Grid.ColumnDefinitions>
                    <Image Grid.RowSpan="2"
                           Source="{Binding ImageUrl}"
                           Aspect="AspectFill"
                           HeightRequest="60"
                           WidthRequest="60" />
                    <Label Grid.Column="1"
                           Text="{Binding Name}"
                           FontAttributes="Bold" />
                    <Label Grid.Row="1"
                           Grid.Column="1"
                           Text="{Binding Location}"
                           FontAttributes="Italic"
                           VerticalOptions="End" />
                </Grid>
            </DataTemplate>
        </CollectionView.ItemTemplate>
    </CollectionView>
</ContentPage>

この例では、GenericsDemo.Models は models XAML 名前空間として定義され、System.Collections.Generic は scg XAML 名前空間として定義されています。 CollectionView.ItemsSource プロパティは、Monkey 型引数を使用してインスタンス化された List<T> に設定されます。 List<Monkey> コレクションは複数の Monkey 項目で初期化され、各 Monkey オブジェクトの外観を定義する DataTemplate が CollectionViewの ItemTemplate として設定されます。

複数の型引数

x:TypeArguments ディレクティブを使用して、コンマで区切られたプレフィックス付き文字列引数として複数の型引数を指定できます。 ジェネリック制約でジェネリック型を使用する場合、入れ子になった制約の型引数はかっこに含まれます。

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:models="clr-namespace:GenericsDemo.Models"
             xmlns:scg="clr-namespace:System.Collections.Generic;assembly=netstandard"
             ...>
    <CollectionView>
        <CollectionView.ItemsSource>
            <scg:List x:TypeArguments="scg:KeyValuePair(x:String,models:Monkey)">
                <scg:KeyValuePair x:TypeArguments="x:String,models:Monkey">
                    <x:Arguments>
                        <x:String>Baboon</x:String>
                        <models:Monkey Location="Africa and Asia"
                                       ImageUrl="https://upload.wikimedia.org/wikipedia/commons/thumb/f/fc/Papio_anubis_%28Serengeti%2C_2009%29.jpg/200px-Papio_anubis_%28Serengeti%2C_2009%29.jpg" />
                    </x:Arguments>
                </scg:KeyValuePair>
                <scg:KeyValuePair x:TypeArguments="x:String,models:Monkey">
                    <x:Arguments>
                        <x:String>Capuchin Monkey</x:String>
                        <models:Monkey Location="Central and South America"
                                       ImageUrl="https://upload.wikimedia.org/wikipedia/commons/thumb/4/40/Capuchin_Costa_Rica.jpg/200px-Capuchin_Costa_Rica.jpg" />   
                    </x:Arguments>
                </scg:KeyValuePair>
                <scg:KeyValuePair x:TypeArguments="x:String,models:Monkey">
                    <x:Arguments>
                        <x:String>Blue Monkey</x:String>
                        <models:Monkey Location="Central and East Africa"
                                       ImageUrl="https://upload.wikimedia.org/wikipedia/commons/thumb/8/83/BlueMonkey.jpg/220px-BlueMonkey.jpg" />
                    </x:Arguments>
                </scg:KeyValuePair>
            </scg:List>
        </CollectionView.ItemsSource>
        <CollectionView.ItemTemplate>
            <DataTemplate>
                <Grid Padding="10">
                    <Grid.RowDefinitions>
                        <RowDefinition Height="Auto" />
                        <RowDefinition Height="Auto" />
                    </Grid.RowDefinitions>
                    <Grid.ColumnDefinitions>
                        <ColumnDefinition Width="Auto" />
                        <ColumnDefinition Width="Auto" />
                    </Grid.ColumnDefinitions>
                    <Image Grid.RowSpan="2"
                           Source="{Binding Value.ImageUrl}"
                           Aspect="AspectFill"
                           HeightRequest="60"
                           WidthRequest="60" />
                    <Label Grid.Column="1"
                           Text="{Binding Key}"
                           FontAttributes="Bold" />
                    <Label Grid.Row="1"
                           Grid.Column="1"
                           Text="{Binding Value.Location}"
                           FontAttributes="Italic"
                           VerticalOptions="End" />
                </Grid>
            </DataTemplate>
        </CollectionView.ItemTemplate>
    </CollectionView>
</ContentPage    

この例では、GenericsDemo.Models は models XAML 名前空間として定義され、System.Collections.Generic は scg XAML 名前空間として定義されています。 CollectionView.ItemsSource プロパティは、KeyValuePair<TKey, TValue> 制約を使用してインスタンス化された List<T> に設定されており、内部制約の型引数として string と Monkeyが使用されています。 List<KeyValuePair<string,Monkey>> コレクションは、既定以外の KeyValuePair コンストラクターを使用して複数の KeyValuePair 項目で初期化され、各 Monkey オブジェクトの外観を定義する DataTemplate が CollectionViewの ItemTemplate として設定されます。 既定以外のコンストラクターに引数を渡す方法については、「コンストラクター引数渡す」を参照してください。