String.TrimEnd Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Surcharges

TrimEnd()	Supprime tous les espaces blancs de fin de la chaîne actuelle.
TrimEnd(Char)	Supprime toutes les occurrences de fin d’un caractère de la chaîne actuelle.
TrimEnd(Char[])	Supprime toutes les occurrences de fin d’un jeu de caractères spécifié dans un tableau de la chaîne actuelle.

TrimEnd()

Source:

String.Manipulation.cs

Supprime tous les espaces blancs de fin de la chaîne actuelle.

public:
 System::String ^ TrimEnd();

public string TrimEnd ();

member this.TrimEnd : unit -> string

Public Function TrimEnd () As String

Retours

String

Chaîne qui reste après que tous les espaces blancs sont supprimés de la fin de la chaîne actuelle. Si aucun caractère ne peut être supprimé de l’instance actuelle, la méthode retourne l’instance actuelle inchangée.

Remarques

La méthode TrimEnd supprime de la chaîne actuelle tous les espaces blancs de fin. L’opération de découpage s’arrête lorsque le premier caractère non blanc est rencontré à la fin de la chaîne. Par exemple, si la chaîne actuelle est « abc xyz », la méthode TrimEnd retourne « abc xyz ».

Note

Si la méthode TrimEnd supprime les caractères de l’instance actuelle, cette méthode ne modifie pas la valeur de l’instance actuelle. Au lieu de cela, elle retourne une nouvelle chaîne dans laquelle tous les espaces blancs de fin sont supprimés de la chaîne actuelle.

TrimEnd(Char)

Source:

String.Manipulation.cs

Supprime toutes les occurrences de fin d’un caractère de la chaîne actuelle.

public:
 System::String ^ TrimEnd(char trimChar);

public string TrimEnd (char trimChar);

member this.TrimEnd : char -> string

Public Function TrimEnd (trimChar As Char) As String

Paramètres

trimChar

Char

Caractère Unicode à supprimer.

Retours

String

Chaîne qui reste après toutes les occurrences du caractère trimChar sont supprimées de la fin de la chaîne actuelle. Si aucun caractère ne peut être supprimé de l’instance actuelle, la méthode retourne l’instance actuelle inchangée.

Remarques

La méthode TrimEnd(System.Char) supprime de la chaîne actuelle tous les caractères de fin trimChar. L’opération de découpage s’arrête lorsque le premier caractère qui n’est pas trimChar est rencontré à la fin de la chaîne. Par exemple, si trimChar est - et que la chaîne actuelle est « ---abc---xyz---- », la méthode TrimEnd(System.Char) retourne « ---abc---xyz ».

Note

Si la méthode TrimEnd(System.Char) supprime les caractères de l’instance actuelle, cette méthode ne modifie pas la valeur de l’instance actuelle. Au lieu de cela, elle retourne une nouvelle chaîne dans laquelle tous les caractères de fin trimChar sont supprimés de la chaîne actuelle.

TrimEnd(Char[])

Source:

String.Manipulation.cs

Supprime toutes les occurrences de fin d’un jeu de caractères spécifié dans un tableau de la chaîne actuelle.

public:
 System::String ^ TrimEnd(... cli::array <char> ^ trimChars);

public string TrimEnd (params char[]? trimChars);

member this.TrimEnd : char[] -> string

Public Function TrimEnd (ParamArray trimChars As Char()) As String

Paramètres

trimChars

Char[]

Tableau de caractères Unicode à supprimer ou null.

Retours

String

La chaîne qui reste après toutes les occurrences des caractères du paramètre trimChars sont supprimées de la fin de la chaîne actuelle. Si trimChars est null ou un tableau vide, les caractères d’espace blanc Unicode sont supprimés à la place. Si aucun caractère ne peut être supprimé de l’instance actuelle, la méthode retourne l’instance actuelle inchangée.

Exemples

L’exemple suivant montre comment utiliser la méthode TrimEnd(System.Char[]) pour découper des marques de ponctuation ou d’espace blanc à partir de la fin d’une chaîne.

string sentence = "The dog had a bone, a ball, and other toys.";
char[] charsToTrim = {',', '.', ' '};
string[] words = sentence.Split();
foreach (string word in words)
   Console.WriteLine(word.TrimEnd(charsToTrim));

// The example displays the following output:
//       The
//       dog
//       had
//       a
//       bone
//       a
//       ball
//       and
//       other
//       toys

let sentence = "The dog had a bone, a ball, and other toys."
let charsToTrim = [| ','; '.'; ' ' |]
let words = sentence.Split()
for word in words do
    printfn $"{word.TrimEnd charsToTrim}"

// The example displays the following output:
//       The
//       dog
//       had
//       a
//       bone
//       a
//       ball
//       and
//       other
//       toys

Module TrimEnd
   Public Sub Main()
      Dim sentence As String = "The dog had a bone, a ball, and other toys."
      Dim charsToTrim() As Char = {","c, "."c, " "c}
      Dim words() As String = sentence.Split()
      For Each word As String In words
         Console.WriteLine(word.TrimEnd(charsToTrim))
      Next
   End Sub
End Module
' The example displays the following output:
'       The
'       dog
'       had
'       a
'       bone
'       a
'       ball
'       and
'       other
'       toys

Remarques

La méthode TrimEnd(System.Char[]) supprime de la chaîne actuelle tous les caractères de fin figurant dans le paramètre trimChars. L’opération de découpage s’arrête lorsque le premier caractère qui n’est pas dans trimChars est rencontré à la fin de la chaîne. Par exemple, si la chaîne actuelle est « 123abc456xyz789 » et trimChars contient les chiffres de « 1 » à « 9 », la méthode TrimEnd(System.Char[]) retourne « 123abc456xyz ».

Note

Si la méthode TrimEnd(System.Char[]) supprime les caractères de l’instance actuelle, cette méthode ne modifie pas la valeur de l’instance actuelle. Au lieu de cela, elle retourne une nouvelle chaîne dans laquelle tous les caractères de fin trouvés dans trimChars sont supprimés de la chaîne actuelle.

Notes pour les appelants

.NET Framework 3.5 SP1 et versions antérieures conservent une liste interne de caractères d’espace blanc que cette méthode supprime si trimChars est null ou un tableau vide. À compter du .NET Framework 4, si trimChars est null ou un tableau vide, la méthode supprime tous les espaces blancs Unicode (autrement dit, les caractères qui produisent une valeur de retour true lorsqu’elles sont passées à la méthode IsWhiteSpace(Char)). En raison de cette modification, la méthode Trim() dans .NET Framework 3.5 SP1 et les versions antérieures supprime deux caractères, ZERO WIDTH SPACE (U+200B) et ZERO WIDTH NO-BREAK SPACE (U+FEFF), que la méthode Trim() dans .NET Framework 4 et versions ultérieures ne supprime pas. En outre, la méthode Trim() dans .NET Framework 3.5 SP1 et les versions antérieures ne supprime pas trois caractères d’espace blanc Unicode : SÉPARATEUR DE VOYELLE MONGOLE (U+180E), NARROW NO-BREAK SPACE (U+202F) et ESPACE MATHÉMATIQUE MOYEN (U+205F).

Voir aussi

• Char
• Trim(Char[])
• TrimStart(Char[])
• IsWhiteSpace(Char)