StringInfo.GetNextTextElement Méthode

Définition

Obtient le premier élément de texte dans une chaîne spécifiée.Gets the first text element in a specified string.

Surcharges

GetNextTextElement(String)

Obtient le premier élément de texte dans une chaîne spécifiée.Gets the first text element in a specified string.

GetNextTextElement(String, Int32)

Obtient l'élément de texte à l'index spécifié de la chaîne spécifiée.Gets the text element at the specified index of the specified string.

GetNextTextElement(String)

Obtient le premier élément de texte dans une chaîne spécifiée.Gets the first text element in a specified string.

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.The string from which to get the text element.

Retours

String

Chaîne contenant le premier élément de texte dans la chaîne spécifiée.A string containing the first text element in the specified string.

Exceptions

str a la valeur null.str is 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, autrement dit, un graphèmes..NET defines a text element as a unit of text that is displayed as a single character, that is, a grapheme. 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.A text element can be a base character, a surrogate pair, or a combining character sequence. La norme Unicode définit une paire de substitution comme une représentation de caractère codé 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 un substitut étendu et la seconde est un substitut faible.The Unicode Standard defines a surrogate pair as a coded character representation for a single abstract character that consists of a sequence of two code units, where the first unit of the pair is a high surrogate and the second is a low surrogate. La norme Unicode définit une séquence de caractères d’association comme une combinaison d’un caractère de base et d’un ou plusieurs caractères d’association.The Unicode Standard defines a combining character sequence as a combination of a base character and one or more combining characters. Une paire de substitution peut représenter un caractère de base ou un caractère d’association.A surrogate pair can represent a base character or a combining character.

Cette méthode retourne uniquement le premier élément de texte.This method only returns the first text element. Pour itérer au sein des éléments de texte de la chaîne, l’application doit utiliser l' TextElementEnumerator objet généré par la GetTextElementEnumerator méthode.To iterate through the text elements of the string, the application should use the TextElementEnumerator object generated by the GetTextElementEnumerator method.

Voir aussi

GetNextTextElement(String, Int32)

Obtient l'élément de texte à l'index spécifié de la chaîne spécifiée.Gets the text element at the specified index of the specified string.

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.The string from which to get the text element.

index
Int32

Index de base zéro au niveau duquel l'élément de texte débute.The zero-based index at which the text element starts.

Retours

String

Chaîne contenant l'élément de texte à l'index spécifié de la chaîne spécifiée.A string containing the text element at the specified index of the specified string.

Exceptions

str a la valeur null.str is null.

index est en dehors de la plage d’index valides pour str.index is outside the range of valid indexes for 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, autrement dit, un graphèmes..NET defines a text element as a unit of text that is displayed as a single character, that is, a grapheme. 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.A text element can be a base character, a surrogate pair, or a combining character sequence. La norme Unicode définit une paire de substitution comme une représentation de caractère codé 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 un substitut étendu et la seconde est un substitut faible.The Unicode Standard defines a surrogate pair as a coded character representation for a single abstract character that consists of a sequence of two code units, where the first unit of the pair is a high surrogate and the second is a low surrogate. La norme Unicode définit une séquence de caractères d’association comme une combinaison d’un caractère de base et d’un ou plusieurs caractères d’association.The Unicode Standard defines a combining character sequence as a combination of a base character and one or more combining characters. Une paire de substitution peut représenter un caractère de base ou un caractère d’association.A surrogate pair can represent a base character or a combining character.

Cette méthode retourne uniquement le premier élément de texte de la sous-chaîne qui commence à l’index spécifié.This method only returns the first text element of the substring that starts at the specified index. Pour itérer au sein des éléments de texte de la chaîne, l’application doit utiliser le TextElementEnumerator généré par la GetTextElementEnumerator méthode.To iterate through the text elements of the string, the application should use the TextElementEnumerator generated by the GetTextElementEnumerator method.

Voir aussi

S’applique à