StringInfo.GetNextTextElement Méthode

Définition

Espace de noms:

System.Globalization

Assemblys:

netstandard.dll, System.Runtime.dll

Obtient le premier élément de texte d’une chaîne spécifiée.

Surcharges

Nom	Description
GetNextTextElement(String)	Obtient le premier élément de texte d’une chaîne spécifiée.
GetNextTextElement(String, Int32)	Obtient l’élément de texte à l’index spécifié de la chaîne spécifiée.

GetNextTextElement(String)

Source:

StringInfo.cs

Obtient le premier élément de texte d’une chaîne spécifiée.

public:
 static System::String ^ GetNextTextElement(System::String ^ str);

public static string GetNextTextElement(string str);

static member GetNextTextElement : string -> string

Public Shared Function GetNextTextElement (str As String) As String

Paramètres

str

String

Chaîne à partir de laquelle obtenir l’élément de texte.

Retours

String

Chaîne contenant le premier élément de texte dans la chaîne spécifiée.

Exceptions

ArgumentNullException

str a la valeur null.

Remarques

.NET définit un élément de texte sous la forme d’une unité de texte qui s’affiche sous la forme d’un caractère unique, autrement dit un graphique. Un élément de texte peut être un caractère de base, une paire de substitution ou une séquence de caractères combinant. La norme Unicode définit une paire de substitution en tant que représentation codée de caractères pour un caractère abstrait unique qui se compose d’une séquence de deux unités de code, où la première unité de la paire est une substitution élevée et la seconde est une substitution faible. La norme Unicode définit une séquence de caractères combinant une combinaison d’un caractère de base et d’un ou plusieurs caractères combinés. Une paire de substitution peut représenter un caractère de base ou un caractère combiné.

Cette méthode retourne uniquement le premier élément de texte. Pour itérer au sein des éléments de texte de la chaîne, l’application doit utiliser l’objet TextElementEnumerator généré par la GetTextElementEnumerator méthode.

Voir aussi

• GetTextElementEnumerator(String)
• ParseCombiningCharacters(String)

GetNextTextElement(String, Int32)

Source:

StringInfo.cs

Obtient l’élément de texte à l’index spécifié de la chaîne spécifiée.

public:
 static System::String ^ GetNextTextElement(System::String ^ str, int index);

public static string GetNextTextElement(string str, int index);

static member GetNextTextElement : string * int -> string

Public Shared Function GetNextTextElement (str As String, index As Integer) As String

Paramètres

str

String

Chaîne à partir de laquelle obtenir l’élément de texte.

index

Int32

Index de base zéro au démarrage de l’élément de texte.

Retours

String

Chaîne contenant l’élément de texte à l’index spécifié de la chaîne spécifiée.

Exceptions

ArgumentNullException

str a la valeur null.

ArgumentOutOfRangeException

index est en dehors de la plage d’index valides pour str.

Remarques

.NET définit un élément de texte sous la forme d’une unité de texte qui s’affiche sous la forme d’un caractère unique, autrement dit un graphique. Un élément de texte peut être un caractère de base, une paire de substitution ou une séquence de caractères combinant. La norme Unicode définit une paire de substitution en tant que représentation codée de caractères pour un caractère abstrait unique qui se compose d’une séquence de deux unités de code, où la première unité de la paire est une substitution élevée et la seconde est une substitution faible. La norme Unicode définit une séquence de caractères combinant une combinaison d’un caractère de base et d’un ou plusieurs caractères combinés. Une paire de substitution peut représenter un caractère de base ou un caractère combiné.

Cette méthode retourne uniquement le premier élément de texte de la sous-chaîne qui commence à l’index spécifié. Pour itérer au sein des éléments de texte de la chaîne, l’application doit utiliser la TextElementEnumerator méthode générée GetTextElementEnumerator .

Voir aussi

• GetTextElementEnumerator(String)
• ParseCombiningCharacters(String)