Informations
Le sujet que vous avez demandé est indiqué ci-dessous. Toutefois, ce sujet ne figure pas dans la bibliothèque.

TextElementEnumerator, classe

Énumère les éléments de texte d'une chaîne.

System.Object
  System.Globalization.TextElementEnumerator

Espace de noms :  System.Globalization
Assembly :  mscorlib (dans mscorlib.dll)

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class TextElementEnumerator : IEnumerator

Le type TextElementEnumerator expose les membres suivants.

  NomDescription
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCurrentObtient l'élément de texte en cours dans la chaîne.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreElementIndexObtient l'index de l'élément de texte sur lequel l'énumérateur est actuellement positionné.
Début

  NomDescription
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégéePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGetTextElementObtient l'élément de texte en cours dans la chaîne.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégéePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMoveNextFait avancer l'énumérateur à l'élément de texte suivant de la chaîne.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreResetAffecte à l'énumérateur sa position initiale, qui précède le premier élément de texte de la chaîne.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreToStringRetourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Début

Le .NET Framework définit un élément de texte comme une unité de texte qui s'affiche sous la forme d'un seul caractère, c'est-à-dire un graphème. Un élément de texte peut être un caractère de base, une paire de substitution ou une séquence de caractères d'association. La norme Unicode définit une paire de substitution comme une représentation de caractères codée pour un caractère abstrait unique qui est constitué d'une séquence de deux unités de code, dans laquelle la première unité de la paire est un substitut étendu et la deuxième est un substitut faible. La norme Unicode définit une séquence de caractères d'association comme combinaison d'un caractère de base et d'un ou plusieurs caractères d'association. Une paire de substitution peut représenter un caractère de base ou un caractère d'association.

Les énumérateurs d'éléments de texte ne sont destinés à être utilisés que pour lire les données de la chaîne. Les énumérateurs ne peuvent pas être utilisés pour modifier la chaîne sous-jacente.

L'énumérateur n'a pas un accès exclusif à la chaîne.

Lorsqu'un énumérateur est créé, il prend un instantané de l'état actuel de la chaîne. Deux énumérateurs créés à partir de la même chaîne au même moment peuvent générer des instantanés différents de la chaîne.

L'énumérateur est dans un état non valide s'il est positionné avant le premier élément de texte ou après le dernier élément de texte de la chaîne. Si l'énumérateur est dans un état non valide, l'appel de Current lève une exception.

Initialement, l'énumérateur est positionné avant le premier élément de type texte dans la chaîne. Reset ramène aussi l'énumérateur à cette position. Par conséquent, après la création d'un énumérateur ou après un appel de Reset, MoveNext doit être appelé pour avancer l'énumérateur au premier élément de texte de la chaîne avant la lecture de la valeur de Current.

Current retourne le même objet jusqu'à l'appel de MoveNext ou de Reset.

Une fois que la fin de la chaîne est passée, l'énumérateur est de nouveau dans un état non valide et l'appel à MoveNext retourne false. L'appel de Current lève une exception si le dernier appel à MoveNext a retourné false.

L'exemple de code suivant illustre l'utilisation de cette classe dans le cadre de l'énumération des éléments de texte d'une chaîne particulière.


using System;
using System.Globalization;


public class SamplesTextElementEnumerator  {

   public static void Main()  {

      // Creates and initializes a String containing the following:
      //   - a surrogate pair (high surrogate U+D800 and low surrogate U+DC00)
      //   - a combining character sequence (the Latin small letter "a" followed by the combining grave accent)
      //   - a base character (the ligature "")
      String myString = "\uD800\uDC00\u0061\u0300\u00C6";

      // Creates and initializes a TextElementEnumerator for myString.
      TextElementEnumerator myTEE = StringInfo.GetTextElementEnumerator( myString );

      // Displays the values returned by ElementIndex, Current and GetTextElement.
      // Current and GetTextElement return a string containing the entire text element. 
      Console.WriteLine( "Index\tCurrent\tGetTextElement" );
      myTEE.Reset();
      while (myTEE.MoveNext())  {
         Console.WriteLine( "[{0}]:\t{1}\t{2}", myTEE.ElementIndex, myTEE.Current, myTEE.GetTextElement() );
      }

   }

}

/*
This code produces the following output.  The question marks take the place of high and low surrogates.

Index   Current GetTextElement
[0]:    ??      ??
[2]:    a`      a`
[4]:    Æ       Æ

*/


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Bibliothèque de classes portable

Pris en charge dans : Bibliothèque de classes portable

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Ajouts de la communauté

Afficher:
© 2014 Microsoft