Generics
XAML app multipiattaforma .NET (.NET MAUI) fornisce supporto per l'utilizzo di tipi CLR generici specificando i vincoli generici come argomenti di tipo. Questo supporto viene fornito dalla x:TypeArguments
direttiva , che passa gli argomenti di tipo con vincoli di un generico al costruttore del tipo generico.
Gli argomenti di tipo vengono specificati come stringa e in genere sono preceduti sys:String
da e sys:Int32
. Il prefisso è obbligatorio perché i tipi tipici di vincoli generici CLR provengono da librerie non mappate agli spazi dei nomi MAUI .NET predefiniti. Tuttavia, i tipi predefiniti XAML 2009, x:String
ad esempio e x:Int32
, possono anche essere specificati come argomenti di tipo, dove x
è lo spazio dei nomi del linguaggio XAML per XAML 2009. Per altre informazioni sui tipi predefiniti XAML 2009, vedi Primitive del linguaggio XAML 2009.
Importante
La definizione di classi generiche in .NET MAUI XAML, con la x:TypeArguments
direttiva , non è supportata.
È possibile specificare più argomenti di tipo usando un delimitatore da virgole. Inoltre, se un vincolo generico usa tipi generici, gli argomenti del tipo di vincolo annidato devono essere contenuti tra parentesi.
Nota
L'estensione x:Type
di markup fornisce un riferimento al tipo CLR (Common Language Runtime) per un tipo generico e ha una funzione simile all'operatore typeof
in C#. Per altre informazioni, vedere estensione di markup x:Type.
Un singolo argomento di tipo primitivo può essere specificato come argomento stringa con prefisso usando la x:TypeArguments
direttiva :
<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>
In questo esempio viene System.Collections.Generic
definito come spazio dei scg
nomi XAML. La CollectionView.ItemsSource
proprietà viene impostata su un List<T>
oggetto di cui viene creata un'istanza con un string
argomento di tipo, usando il tipo predefinito x:String
XAML 2009. La List<string>
raccolta viene inizializzata con più string
elementi.
In alternativa, ma in modo equivalente, è possibile creare un'istanza della List<T>
raccolta con il tipo CLR String
:
<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>
Un singolo argomento del tipo di oggetto può essere specificato come argomento stringa con prefisso usando la x:TypeArguments
direttiva :
<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>
In questo esempio viene GenericsDemo.Models
definito come spazio models
dei nomi XAML ed System.Collections.Generic
è definito come spazio dei scg
nomi XAML. La CollectionView.ItemsSource
proprietà è impostata su un List<T>
oggetto di cui viene creata un'istanza con un Monkey
argomento di tipo. L'insieme List<Monkey>
viene inizializzato con più Monkey
elementi e un oggetto DataTemplate
che definisce l'aspetto di ogni Monkey
oggetto viene impostato come dell'oggetto ItemTemplate
CollectionView.
È possibile specificare più argomenti di tipo come argomenti stringa con prefisso, delimitati da una virgola, usando la x:TypeArguments
direttiva . Quando un vincolo generico usa tipi generici, gli argomenti del tipo di vincolo annidato sono contenuti tra parentesi:
<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
In questo esempio viene GenericsDemo.Models
definito come spazio models
dei nomi XAML ed System.Collections.Generic
è definito come spazio dei scg
nomi XAML. La CollectionView.ItemsSource
proprietà viene impostata su un List<T>
oggetto di cui viene creata un'istanza con un KeyValuePair<TKey, TValue>
vincolo, con gli string
argomenti del tipo di vincolo interno e Monkey
. L'insieme List<KeyValuePair<string,Monkey>>
viene inizializzato con più KeyValuePair
elementi, utilizzando il costruttore non predefinito KeyValuePair
e un oggetto DataTemplate
che definisce l'aspetto di ogni Monkey
oggetto viene impostato come ItemTemplate
dell'oggetto CollectionView. Per informazioni sul passaggio di argomenti a un costruttore non predefinito, vedere Passare argomenti del costruttore.