Partager via


StringInfo.GetNextTextElement Méthode

Définition

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

Surcharges

GetNextTextElement(String)

Obtient le premier élément de texte dans 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
Source:
StringInfo.cs
Source:
StringInfo.cs

Obtient le premier élément de texte dans 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 dans laquelle obtenir l'élément de texte.

Retours

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

Exceptions

str a la valeur null.

Remarques

.NET définit un élément de texte comme une unité de texte qui s’affiche sous la forme d’un caractère unique, c’est-à-dire d’un graphème. Un élément de texte peut être un caractère de base, une paire de substituts ou une séquence de caractères combinant. La norme Unicode définit une paire de substitution comme une représentation codée d’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 un substitut élevé et la seconde est une substitution faible. La norme Unicode définit une séquence de caractères combinant un caractère de base et un ou plusieurs caractères de combinaison. Une paire de substitution peut représenter un caractère de base ou un caractère de combinaison.

Cette méthode retourne uniquement le premier élément de texte. Pour itérer à travers les é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

S’applique à

GetNextTextElement(String, Int32)

Source:
StringInfo.cs
Source:
StringInfo.cs
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 dans laquelle obtenir l'élément de texte.

index
Int32

Index de base zéro au niveau duquel l'élément de texte débute.

Retours

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

Exceptions

str a la valeur null.

index n’est pas compris dans la plage d’index valides pour str.

Remarques

.NET définit un élément de texte comme une unité de texte qui s’affiche sous la forme d’un caractère unique, c’est-à-dire d’un graphème. Un élément de texte peut être un caractère de base, une paire de substituts ou une séquence de caractères combinant. La norme Unicode définit une paire de substitution comme une représentation codée d’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 un substitut élevé et la seconde est une substitution faible. La norme Unicode définit une séquence de caractères combinant un caractère de base et un ou plusieurs caractères de combinaison. Une paire de substitution peut représenter un caractère de base ou un caractère de combinaison.

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 à travers les éléments de texte de la chaîne, l’application doit utiliser le TextElementEnumerator généré par la GetTextElementEnumerator méthode .

Voir aussi

S’applique à