StringInfo.SubstringByTextElements Méthode

Définition

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
Source:
StringInfo.cs
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 string SubstringByTextElements (int startingTextElement);

Paramètres

startingTextElement
Int32

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

Retours

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

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.

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

SubstringByTextElements(Int32, Int32)

Source:
StringInfo.cs
Source:
StringInfo.cs
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 string SubstringByTextElements (int startingTextElement, int lengthInTextElements);

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

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

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.

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1