StringInfo.SubstringByTextElements Méthode

Définition

Espace de noms:

System.Globalization

Assembly:

System.Runtime.dll

Récupère une sous-chaîne d'éléments de texte à partir de l'objet StringInfo en cours.

Surcharges

SubstringByTextElements(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.
SubstringByTextElements(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.

SubstringByTextElements(Int32)

Source:

StringInfo.cs

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.

public:
 System::String ^ SubstringByTextElements(int startingTextElement);

public string SubstringByTextElements (int startingTextElement);

member this.SubstringByTextElements : int -> string

Public Function SubstringByTextElements (startingTextElement As Integer) As String

Paramètres

startingTextElement

Int32

Index de base zéro d'un élément de texte dans cet objet StringInfo.

Retours

String

Sous-chaîne d'éléments de texte dans cet objet StringInfo, commençant à l'index d'élément de texte spécifié par le paramètre startingTextElement et continuant jusqu'au dernier élément de texte dans cet objet.

Exceptions

ArgumentOutOfRangeException

startingTextElement est inférieur à zéro.

- ou -

La chaîne qui est la valeur de l'objet StringInfo en cours est la chaîne vide ("").

Remarques

Prenons l’exemple d’une chaîne composée de cinq éléments de texte, indexés de 0 à 4. Si le paramètre a la startingTextElement valeur 1, la SubstringByTextElements méthode retourne une sous-chaîne qui se compose des éléments de texte pour lesquels les index sont 1, 2, 3 et 4.

SubstringByTextElements(Int32, Int32)

Source:

StringInfo.cs

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.

public:
 System::String ^ SubstringByTextElements(int startingTextElement, int lengthInTextElements);

public string SubstringByTextElements (int startingTextElement, int lengthInTextElements);

member this.SubstringByTextElements : int * int -> string

Public Function SubstringByTextElements (startingTextElement As Integer, lengthInTextElements As Integer) As String

Paramètres

startingTextElement

Int32

Index de base zéro d'un élément de texte dans cet objet StringInfo.

lengthInTextElements

Int32

Nombre d'éléments de texte à récupérer.

Retours

String

Sous-chaîne d'éléments de texte dans cet objet StringInfo. La sous-chaîne se compose du nombre d'éléments de texte spécifié par le paramètre lengthInTextElements et commence à l'index d'élément de texte spécifié par le paramètre startingTextElement.

Exceptions

ArgumentOutOfRangeException

startingTextElement est inférieur à zéro.

- ou -

startingTextElement est supérieur ou égal à la longueur de la chaîne qui est la valeur de l'objet StringInfo en cours.

- ou -

lengthInTextElements est inférieur à zéro.

- ou -

La chaîne qui est la valeur de l'objet StringInfo en cours est la chaîne vide ("").

- ou -

startingTextElement + lengthInTextElements spécifient un index qui est supérieur au nombre d’éléments de texte dans cet objet StringInfo.

Remarques

Prenons l’exemple d’une chaîne composée de cinq éléments de texte, indexés de 0 à 4. Si le paramètre a la startingTextElement valeur 1 et que le lengthInTextElements paramètre est 3, la SubstringByTextElements méthode retourne une sous-chaîne qui se compose des éléments de texte pour lesquels les index sont 1, 2 et 3.