Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Les liaisons de données de l’interface utilisateur d’application multiplateforme .NET (.NET MAUI) transfèrent généralement des données d’une propriété source vers une propriété cible, et, dans certains cas, de la propriété cible à la propriété source. Ce transfert est simple lorsque les propriétés source et cible sont du même type, ou lorsqu’un type peut être converti en l’autre par le biais d’une conversion implicite. Lorsque ce n’est pas le cas, une conversion de type doit avoir lieu.
Pour plus d’informations sur les convertisseurs, reportez-vous à la documentation .NET MAUI.
Convertisseurs .NET MAUI Community Toolkit
Le kit de ressources communauté .NET MAUI fournit une collection de convertisseurs prédéfinis et réutilisables pour faciliter la vie des développeurs. Voici les convertisseurs fournis par le kit de ressources :
Converter | Description |
---|---|
BoolToObjectConverter |
BoolToObjectConverter est un convertisseur qui permet aux utilisateurs de convertir une bool liaison de valeur en un objet spécifique. |
ByteArrayToImageSourceConverter |
ByteArrayToImageSourceConverter est un convertisseur qui permet à l’utilisateur de convertir une valeur entrante à partir d’un tableau byte et retourne ensuite un ImageSource . |
ColorToBlackOrWhiteConverter |
Le ColorToBlackOrWhiteConverter est un convertisseur unidirectionnel qui permet aux utilisateurs de convertir un Color entrant en une valeur monochrome de Colors.Black ou Colors.White . |
ColorToByteAlphaConverter |
Il ColorToByteAlphaConverter s’agit d’un convertisseur unidirectionnel qui permet aux utilisateurs de convertir un entrant Color en composant alpha sous forme de valeur comprise entre 0 et 255. |
ColorToByteBlueConverter |
Le ColorToByteBlueConverter est un convertisseur unidirectionnel qui permet aux utilisateurs de convertir une entrée Color en le composant bleu sous forme de valeur comprise entre 0 et 255. |
ColorToByteGreenConverter |
ColorToByteGreenConverter est un convertisseur unidirectionnel qui permet aux utilisateurs de convertir un Color entrant en le composant vert sous forme de valeur comprise entre 0 et 255. |
ColorToByteRedConverter |
Le ColorToByteRedConverter est un convertisseur unidirectionnel qui permet aux utilisateurs de convertir un Color entrant en valeur du composant rouge sous la forme d’une valeur comprise entre 0 et 255. |
ColorToCmykStringConverter |
Le ColorToCmykStringConverter est un convertisseur unidirectionnel qui permet aux utilisateurs de convertir une Color liaison de valeurs en son équivalent CMYK string . |
ColorToCmykaStringConverter |
ColorToCmykaStringConverter est un convertisseur unidirectionnel qui permet aux utilisateurs de convertir une liaison de données de valeur Color en son équivalent CMYKA string . |
ColorToColorForTextConverter |
Le ColorToColorForTextConverter est un convertisseur unidirectionnel qui permet aux utilisateurs de convertir un Color entrant en une valeur monochrome de Colors.Black ou Colors.White en fonction de sa détermination comme étant sombre pour l'œil humain. |
ColorToDegreeHueConverter |
Le ColorToDegreeHueConverter est un convertisseur à sens unique qui permet aux utilisateurs de convertir un Color entrant en composante de teinte sous la forme d'une valeur comprise entre 0 et 360. |
ColorToGrayScaleColorConverter |
Le ColorToGrayScaleColorConverter est un convertisseur unidirectionnel qui permet aux utilisateurs de convertir un Color entrant en un Color en niveaux de gris. |
ColorToHexRgbStringConverter |
Le ColorToHexRgbStringConverter est un convertisseur qui permet aux utilisateurs de convertir une valeur Color en son équivalent hexadécimal RVB string . |
ColorToHexRgbaStringConverter |
Le ColorToHexRgbaStringConverter est un convertisseur qui permet aux utilisateurs de convertir une valeur Color en son équivalent hexadécimal RGBA string . |
ColorToHslStringConverter |
Le ColorToHslStringConverter est un convertisseur à sens unique qui permet aux utilisateurs de transformer une liaison de valeur Color en son équivalent HSL string . |
ColorToHslaStringConverter |
ColorToHslaStringConverter est un convertisseur unidirectionnel qui permet aux utilisateurs de convertir une liaison de valeurs Color en son équivalent HSLA string . |
ColorToInverseColorConverter |
Il ColorToInverseColorConverter s’agit d’un convertisseur unidirectionnel qui permet aux utilisateurs de convertir un entrant Color en son inverse. |
ColorToPercentBlackKeyConverter |
ColorToPercentBlackKeyConverter est un convertisseur unidirectionnel qui permet aux utilisateurs de convertir un Color entrant en le composant clé en une valeur comprise entre 0 et 1. |
ColorToPercentCyanConverter |
Le ColorToPercentCyanConverter est un convertisseur unidirectionnel qui permet aux utilisateurs de convertir un Color entrant en composant cyan comme une valeur comprise entre 0 et 1. |
ColorToPercentMagentaConverter |
Le ColorToPercentMagentaConverter est un convertisseur unidirectionnel qui permet aux utilisateurs de convertir un Color entrant en composant magenta sous forme d’une valeur comprise entre 0 et 1. |
ColorToPercentYellowConverter |
Le ColorToPercentYellowConverter est un convertisseur unidirectionnel qui permet aux utilisateurs de convertir un Color entrant en composant jaune sous la forme d’une valeur comprise entre 0 et 1. |
ColorToRgbStringConverter |
ColorToRgbStringConverter est un convertisseur qui permet aux utilisateurs de convertir une liaison de valeurs Color en son équivalent RVB string . |
ColorToRgbaStringConverter |
Le ColorToRgbaStringConverter est un convertisseur à sens unique qui permet aux utilisateurs de convertir une valeur Color en son équivalent RGBA string . |
CompareConverter |
CompareConverter est un convertisseur unidirectionnel qui prend une valeur entrante implémentant IComparable , la compare à une valeur spécifiée et retourne le résultat de la comparaison. |
DateTimeOffsetConverter |
Il DateTimeOffsetConverter s’agit d’un convertisseur qui permet aux utilisateurs de convertir un DateTimeOffset en un DateTime |
DoubleToIntConverter |
Il DoubleToIntConverter s’agit d’un convertisseur qui permet aux utilisateurs de convertir une valeur entrante double en un int et inversement. Si vous le souhaitez, l’utilisateur peut fournir un multiplicateur à la conversion par le biais de la Ratio propriété. |
EnumToBoolConverter |
Le EnumToBoolConverter est un convertisseur unidirectionnel qui vous permet de transformer un Enum en un bool correspondant s'il est égal à un ensemble de valeurs d'énumération fournies. Il est utile de lier une collection de valeurs représentant un type d’énumération à une propriété de contrôle booléenne comme la IsVisible propriété. |
EnumToIntConverter |
Il EnumToIntConverter s’agit d’un convertisseur qui vous permet de convertir une norme Enum (extension int) en son type primitif int sous-jacent. Il est utile de lier une collection de valeurs représentant un type d’énumération avec une numérotation par défaut à un contrôle tel qu’un Picker . |
ImageResourceConverter |
Le ImageResourceConverter est un convertisseur qui convertit l'ID de la ressource image intégrée en son ImageSource. |
IndexToArrayItemConverter |
Le IndexToArrayItemConverter est un convertisseur qui permet aux utilisateurs de convertir une valeur int en un élément d'un tableau. La int valeur liée aux données représente l’indexeur utilisé pour accéder au tableau. Le tableau est passé-through par le ConverterParameter . |
IntToBoolConverter |
Il IntToBoolConverter s’agit d’un convertisseur qui permet aux utilisateurs de convertir une valeur entrante int en une bool et inversement. |
InvertedBoolConverter |
Il InvertedBoolConverter s’agit d’un convertisseur qui permet aux utilisateurs de convertir un bool à son inverse - true devient false et vice versa. |
IsEqualConverter |
Le IsEqualConverter est un convertisseur unidirectionnel qui retourne un bool indiquant si la valeur de liaison est égale à une autre valeur spécifiée. |
IsInRangeConverter |
Il IsInRangeConverter s’agit d’un convertisseur unidirectionnel qui prend une valeur entrante implémentant IComparable , et une valeur minimale et maximale, et retourne le résultat de la valeur comprise entre les valeurs minimales et maximales. |
IsListNotNullOrEmptyConverter |
IsListNotNullOrEmptyConverter est un convertisseur unidirectionnel qui convertit IEnumerable en une valeur bool . |
IsListNullOrEmptyConverter |
IsListNullOrEmptyConverter est un convertisseur unidirectionnel qui convertit IEnumerable en une valeur bool . |
IsNotEqualConverter |
IsNotEqualConverter est un convertisseur unidirectionnel qui retourne un bool indiquant si la valeur de liaison n’est pas égale à une autre valeur spécifiée. |
IsNullConverter |
IsNullConverter est un convertisseur qui permet aux utilisateurs de transformer une liaison entrante en une valeur bool . Cette valeur représente si la valeur de liaison entrante est Null. |
IsNotNullConverter |
Le IsNotNullConverter est un convertisseur qui permet aux utilisateurs de convertir une liaison entrante en une valeur bool . Cette valeur indique si la valeur de liaison entrante n'est pas nulle. |
IsStringNotNullOrEmptyConverter |
S’agit d’un convertisseur unidirectionnel qui retourne un bool indiquant si la valeur de liaison n’est pas null et n’est pas une string.Empty . |
IsStringNotNullOrWhiteSpaceConverter |
Le IsStringNotNullOrWhiteSpaceConverter est un convertisseur à sens unique qui renvoie un bool indiquant si la valeur de liaison n'est pas nulle, n'est pas un string.Empty et ne contient pas de caractères d'espacement uniquement. |
IsStringNullOrEmptyConverter |
Le IsStringNullOrEmptyConverter est un convertisseur unidirectionnel qui retourne un bool indiquant si la valeur de liaison est null ou string.Empty . |
IsStringNullOrWhiteSpaceConverter |
Le IsStringNullOrWhiteSpaceConverter est un convertisseur unidirectionnel qui retourne un bool indiquant si la valeur de liaison est nulle, string.Empty ou contient uniquement des caractères d'espacement. |
ItemTappedEventArgsConverter |
ItemTappedEventArgsConverter est un convertisseur qui permet aux utilisateurs d’extraire la valeur de l'Item d’un objet ItemTappedEventArgs . Il peut ensuite être utilisé en combinaison avec EventToCommandBehavior. |
ListToStringConverter |
Le ListToStringConverter est un convertisseur unidirectionnel qui fournit une concaténation des éléments d'une collection, avec le séparateur spécifié entre chaque élément. |
MathExpressionConverter |
Le MathExpressionConverter est un convertisseur qui permet d'effectuer diverses opérations mathématiques. |
MultiConverter |
MultiConverter convertit une valeur entrante à l’aide de tous les convertisseurs entrants en séquence. |
MultiMathExpressionConverter |
MultiMathExpressionConverter est un convertisseur qui permet aux utilisateurs de réaliser diverses opérations mathématiques avec plusieurs valeurs à l’aide d’un MultiBinding . |
SelectedItemEventArgsConverter |
SelectedItemEventArgsConverter est un convertisseur qui permet aux utilisateurs d'extraire la valeur de l'Item à partir d'un objet SelectedItemEventArgs . Il peut ensuite être utilisé en combinaison avec EventToCommandBehavior. |
StateToBoolConverter |
Le StateToBoolConverter est un convertisseur unidirectionnel qui retourne un boolean résultat selon que la valeur fournie est d'un type spécifique LayoutState . |
StringToListConverter |
Le StringToListConverter est un convertisseur unidirectionnel qui retourne un ensemble de sous-chaînes en fractionnant la chaîne d’entrée en utilisant un ou plusieurs séparateurs. |
TextCaseConverter |
Le TextCaseConverter est un convertisseur à sens unique qui permet aux utilisateurs de convertir la casse d'une liaison de type string entrante. La propriété Type permet de définir le type de casse qui sera appliqué à la chaîne. |
VariableMultiValueConverter |
VariableMultiValueConverter est un convertisseur qui permet aux utilisateurs de convertir bool des valeurs via un MultiBinding en un seul bool . |
Créer un convertisseur .NET MAUI Community Toolkit
Le Kit de ressources de la communauté .NET MAUI fournit des implémentations sûres de type de l'interface IValueConverter
fournie par .NET MAUI, ce qui permet aux développeurs d'écrire des convertisseurs de type sûr plus concis. Le kit de ressources fournit les options suivantes
Convertisseur bidirectionnel
La BaseConverter
classe fournit aux développeurs la possibilité de définir le type de valeur entrant et également le type de valeur sortant pour une IValueConverter
implémentation qui prend en charge une liaison bidirectionnelle. L’exemple suivant montre comment créer un convertisseur qui convertit une bool
valeur en Colors.Green
si true
et Colors.Red
si false
.
public class BoolToColorConverter : BaseConverter<bool, Color>
{
public override Color DefaultConvertReturnValue { get; set; } = Colors.Orange;
public override bool DefaultConvertBackReturnValue { get; set; } = false;
public override string ConvertFrom(bool value, CultureInfo? culture)
{
return value ? Colors.Green : Colors.Red;
}
public override int ConvertBackTo(Color value, CultureInfo? culture)
{
return value == Colors.Green;
}
}
Le DefaultConvertReturnValue
sera utilisé par l'implémentation de base et renvoyé si une exception est levée dans la méthode ConvertFrom
.
Le DefaultConvertBackReturnValue
sera utilisé par l'implémentation de base et renvoyé si une exception est levée dans la méthode ConvertBackTo
.
Avertissement
Le convertisseur lèvera une ArgumentException
si les valeurs d'entrée ou de sortie ne sont pas du type attendu. Le lancement d'exceptions peut être désactivé en attribuant à CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters
la valeur false
.
Convertisseur unidirectionnel
La BaseConverterOneWay
classe fournit aux développeurs la possibilité de définir le type de valeur entrante et également le type de valeur sortant pour une IValueConverter
implémentation qui prend en charge une liaison unidirectionnelle. L’exemple suivant montre comment créer un convertisseur qui convertit une bool
valeur en Colors.Green
si true
et Colors.Red
si false
.
public class BoolToColorConverter : BaseConverterOneWay<bool, Color>
{
public override Color DefaultConvertReturnValue { get; set; } = Colors.Orange
public override string ConvertFrom(bool value, CultureInfo? culture)
{
return value ? Colors.Green : Colors.Red;
}
}
Le DefaultConvertReturnValue
sera utilisé par l'implémentation de base et retourné si une exception est lancée à l'intérieur de la méthode ConvertFrom
.
Avertissement
Le convertisseur lance une ArgumentException
si les valeurs entrantes ou sortantes ne sont pas du type attendu. Le lancement d'exceptions peut être désactivé en attribuant à CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters
la valeur false
.
Le convertisseur renverra un NotSupportedException
s'il est utilisé dans une liaison bidirectionnelle.
.NET MAUI Community Toolkit