Character​Grouping Character​Grouping Character​Grouping Class


A container for character group information. Characters are grouped in an index that enables an application to determine where the grouping boundaries are.

public : sealed class CharacterGrouping : ICharacterGroupingpublic sealed class CharacterGrouping : ICharacterGroupingPublic NotInheritable Class CharacterGrouping Implements ICharacterGrouping
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)


// 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;


First First First

Gets the first item that appears in the grouping under this index.

public : PlatForm::String First { get; }public string First { get; }Public ReadOnly Property First As string
PlatForm::String string string

The string that defines the start of the group that has the associated label. The start of the next group implicitly determines its end.


Label Label Label

Gets the label that is associated with this index.

public : PlatForm::String Label { get; }public string Label { get; }Public ReadOnly Property Label As string
PlatForm::String string string

The string to use as the label for all strings of this group. This string may be empty, in which case the label is considered to be "other".