Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais
Cette documentation est archivée et n’est pas conservée.

StringInfo, classe

Fournit une fonctionnalité permettant de diviser une chaîne en éléments de texte et d'itérer au sein de ces éléments de texte.

System.Object
  System.Globalization.StringInfo

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

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class StringInfo

Le type StringInfo expose les membres suivants.

  NomDescription
Méthode publiquePris en charge par XNA Frameworkc4hkht93.PortableClassLibrary(fr-fr,VS.100).gifStringInfo()Initialise une nouvelle instance de la classe StringInfo.
Méthode publiquePris en charge par XNA Frameworkc4hkht93.PortableClassLibrary(fr-fr,VS.100).gifStringInfo(String)Initialise une nouvelle instance de la classe StringInfo avec une chaîne spécifiée.
Début

  NomDescription
Propriété publiquePris en charge par XNA Frameworkc4hkht93.PortableClassLibrary(fr-fr,VS.100).gifLengthInTextElementsObtient le nombre d'éléments de texte dans l'objet StringInfo en cours.
Propriété publiquePris en charge par XNA Frameworkc4hkht93.PortableClassLibrary(fr-fr,VS.100).gifStringObtient ou définit la valeur de l'objet StringInfo en cours.
Début

  NomDescription
Méthode publiquePris en charge par XNA Frameworkc4hkht93.PortableClassLibrary(fr-fr,VS.100).gifEqualsIndique si l'objet StringInfo en cours est égal à un objet spécifié. (Substitue Object.Equals(Object).)
Méthode protégéePris en charge par XNA Frameworkc4hkht93.PortableClassLibrary(fr-fr,VS.100).gifFinalize 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 Frameworkc4hkht93.PortableClassLibrary(fr-fr,VS.100).gifGetHashCodeCalcule un code de hachage pour la valeur de l'objet StringInfo en cours. (Substitue Object.GetHashCode().)
Méthode publiqueMembre statiquePris en charge par XNA Frameworkc4hkht93.PortableClassLibrary(fr-fr,VS.100).gifGetNextTextElement(String)Obtient le premier élément de texte dans une chaîne spécifiée.
Méthode publiqueMembre statiquePris en charge par XNA Frameworkc4hkht93.PortableClassLibrary(fr-fr,VS.100).gifGetNextTextElement(String, Int32)Obtient l'élément de texte à l'index spécifié de la chaîne spécifiée.
Méthode publiqueMembre statiquePris en charge par XNA Frameworkc4hkht93.PortableClassLibrary(fr-fr,VS.100).gifGetTextElementEnumerator(String)Retourne un énumérateur qui itère au sein des éléments de texte de l'ensemble de la chaîne.
Méthode publiqueMembre statiquePris en charge par XNA Frameworkc4hkht93.PortableClassLibrary(fr-fr,VS.100).gifGetTextElementEnumerator(String, Int32)Retourne un énumérateur qui itère au sein des éléments de texte de la chaîne, en commençant à l'index spécifié.
Méthode publiquePris en charge par XNA Frameworkc4hkht93.PortableClassLibrary(fr-fr,VS.100).gifGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégéePris en charge par XNA Frameworkc4hkht93.PortableClassLibrary(fr-fr,VS.100).gifMemberwiseCloneCrée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode publiqueMembre statiquePris en charge par XNA Frameworkc4hkht93.PortableClassLibrary(fr-fr,VS.100).gifParseCombiningCharactersRetourne les index de tous les caractères de base, substituts étendus ou caractères de contrôle dans la chaîne spécifiée.
Méthode publiqueSubstringByTextElements(Int32)Récupère une sous-chaîne d'éléments de texte à partir de l'objet StringInfo en cours, commençant à un élément de texte spécifié et continuant jusqu'au dernier élément de texte.
Méthode publiqueSubstringByTextElements(Int32, Int32)Récupère une sous-chaîne d'éléments de texte à partir de l'objet StringInfo en cours, commençant à un élément de texte spécifié et continuant pour le nombre spécifié d'éléments de texte.
Méthode publiquePris en charge par XNA Frameworkc4hkht93.PortableClassLibrary(fr-fr,VS.100).gifToStringRetourne une chaîne qui représente l'objet actuel. (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.

Cet exemple montre comment utiliser les méthodes GetTextElementEnumerator et ParseCombiningCharacters de la classe StringInfo pour manipuler une chaîne qui contient des caractères de substitution et d'association.


using System;
using System.Text;
using System.Globalization;

public sealed class App {
   static void Main() {
      // The string below contains combining characters.
      String s = "a\u0304\u0308bc\u0327";

      // Show each 'character' in the string.
      EnumTextElements(s);

      // Show the index in the string where each 'character' starts.
      EnumTextElementIndexes(s);
   }

   // Show how to enumerate each real character (honoring surrogates) in a string.
   static void EnumTextElements(String s) {
      // This StringBuilder holds the output results.
      StringBuilder sb = new StringBuilder();

      // Use the enumerator returned from GetTextElementEnumerator 
      // method to examine each real character.
      TextElementEnumerator charEnum = StringInfo.GetTextElementEnumerator(s);
      while (charEnum.MoveNext()) {
         sb.AppendFormat(
           "Character at index {0} is '{1}'{2}",
           charEnum.ElementIndex, charEnum.GetTextElement(),
           Environment.NewLine);
      }

      // Show the results.
      Console.WriteLine("Result of GetTextElementEnumerator:");
      Console.WriteLine(sb);
   }

   // Show how to discover the index of each real character (honoring surrogates) in a string.
   static void EnumTextElementIndexes(String s) {
      // This StringBuilder holds the output results.
      StringBuilder sb = new StringBuilder();

      // Use the ParseCombiningCharacters method to 
      // get the index of each real character in the string.
      Int32[] textElemIndex = StringInfo.ParseCombiningCharacters(s);

      // Iterate through each real character showing the character and the index where it was found.
      for (Int32 i = 0; i < textElemIndex.Length; i++) {
         sb.AppendFormat(
            "Character {0} starts at index {1}{2}",
            i, textElemIndex[i], Environment.NewLine);
      }

      // Show the results.
      Console.WriteLine("Result of ParseCombiningCharacters:");
      Console.WriteLine(sb);
   }
}

// This code produces the following output.
//
// Result of GetTextElementEnumerator:
// Character at index 0 is 'a-"'
// Character at index 3 is 'b'
// Character at index 4 is 'c,'
// 
// Result of ParseCombiningCharacters:
// Character 0 starts at index 0
// Character 1 starts at index 3
// Character 2 starts at index 4


.NET Framework

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

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Pris en charge dans :

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

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.
Afficher: