CharacterGroupings Classe

Définition

Espace de noms:

Windows.Globalization.Collation

Contient l’ensemble de groupes de caractères et les fonctionnalités permettant d’obtenir l’étiquette d’une chaîne donnée.

public ref class CharacterGroupings sealed : IIterable<CharacterGrouping ^>, IVectorView<CharacterGrouping ^>

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.Globalization.Collation.ICharacterGroupingsFactory, 262144, "Windows.Foundation.UniversalApiContract")]
class CharacterGroupings final : IIterable<CharacterGrouping>, IVectorView<CharacterGrouping>

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Globalization.Collation.ICharacterGroupingsFactory), 262144, "Windows.Foundation.UniversalApiContract")]
public sealed class CharacterGroupings : IEnumerable<CharacterGrouping>, IReadOnlyList<CharacterGrouping>

function CharacterGroupings(language)

Public NotInheritable Class CharacterGroupings
Implements IEnumerable(Of CharacterGrouping), IReadOnlyList(Of CharacterGrouping)

Héritage

Object Platform::Object IInspectable CharacterGroupings

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente

IIterable<T> IEnumerable<T> IIterable<CharacterGrouping> IEnumerable<CharacterGrouping> IVectorView<CharacterGrouping> IReadOnlyList<CharacterGrouping>

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

// Create a CharacterGroupings object for the default collation.
var characterGroupings = new Windows.Globalization.Collation.CharacterGroupings();
// Get the number of CharacterGrouping objects.
var size = characterGroupings.size;
if (size > 0) {
    // Get the first characterGrouping.
    var characterGrouping = characterGroupings.getAt(0);
    // Get the first item in this characterGrouping.
    var first = characterGrouping.first;
    // Get the label of the first item in this characterGrouping.
    var label = characterGrouping.label;
}

Remarques

Listes de membres de la collection

Pour JavaScript, CharacterGroupings a les membres affichés dans les listes de membres. En outre, CharacterGroupings prend en charge une propriété length , les membres de Array.prototype et l’utilisation d’un index pour accéder aux éléments.

Énumération de la collection en C# ou Microsoft Visual Basic

CharacterGroupings étant énumérable, vous pouvez utiliser une syntaxe spécifique au langage, telle que foreach en C# pour énumérer les éléments de la collection. Le compilateur effectue le casting de type pour vous et vous n’aurez pas besoin de caster IEnumerable<CharacterGrouping> explicitement. Si vous avez besoin de caster explicitement, par exemple si vous souhaitez appeler GetEnumerator, castez en IEnumerable<T> avec une contrainte CharacterGrouping .

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1703	15063	CharacterGroupings(String)

Constructeurs

CharacterGroupings()	Créez un objet CharacterGroupings pour le classement par défaut.
CharacterGroupings(String)	Créez un objet CharacterGroupings pour le classement appartenant à la langue donnée.

Propriétés

Size	Obtient le nombre d’objets CharacterGrouping dans l’ensemble de groupes de caractères.

Méthodes

First()	Retourne un itérateur pour énumérer les éléments dans le jeu de groupes de caractères.
GetAt(UInt32)	Retourne le CharacterGrouping à l’index spécifié dans l’ensemble de groupes de caractères.
GetMany(UInt32, CharacterGrouping[])	Renvoie les objets CharacterGrouping qui commencent à l’index spécifié dans l’ensemble de groupes de caractères.
IndexOf(CharacterGrouping, UInt32)	Retourne l’index d’un objet CharacterGrouping spécifié dans l’ensemble de groupes de caractères.
Lookup(String)	Obtient l’étiquette sous laquelle tombe le texte fourni.