String.TrimEnd Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Surcharges

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

TrimEnd()

Source:

String.Manipulation.cs

Supprime tous les caractères correspondant à un espace blanc à la 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 restante après la suppression de tous les caractères correspondant à un espace blanc à la fin de la chaîne actuelle. Si aucun caractère ne peut être tronqué dans l'instance active, la méthode retourne l'instance active inchangée.

Remarques

La TrimEnd méthode 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-espace blanc est rencontré à la fin de la chaîne. Par exemple, si la chaîne actuelle est « abc xyz », la TrimEnd méthode retourne « abc xyz ».

Notes

Si la TrimEnd méthode supprime des caractères de la instance actuelle, cette méthode ne modifie pas la valeur du instance actuel. Au lieu de cela, il 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 d’un caractère à la fin 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 restante après la suppression de toutes les occurrences du caractère trimChar à la fin de la chaîne actuelle. Si aucun caractère ne peut être tronqué dans l'instance active, la méthode retourne l'instance active inchangée.

Remarques

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

Notes

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

TrimEnd(Char[])

Source:

String.Manipulation.cs

Supprime toutes les occurrences du jeu de caractères spécifié dans un tableau à la fin 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

Chaîne qui reste après la suppression de toutes les occurrences des caractères contenus dans le paramètre trimChars de la fin de la chaîne actuelle. Si trimChars est null ou un tableau vide, ce sont les espaces blancs Unicode qui sont supprimés. Si aucun caractère ne peut être tronqué dans l'instance active, la méthode retourne l'instance active inchangée.

Exemples

L’exemple suivant montre comment utiliser la méthode pour réduire les TrimEnd(System.Char[]) espaces blancs ou les marques de ponctuation à 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 TrimEnd(System.Char[]) méthode supprime de la chaîne actuelle tous les caractères de fin qui se trouvent dans le trimChars paramètre. 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 TrimEnd(System.Char[]) méthode retourne « 123abc456xyz ».

Notes

Si la TrimEnd(System.Char[]) méthode supprime des caractères de la instance actuelle, cette méthode ne modifie pas la valeur du instance actuel. Au lieu de cela, il 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

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

Voir aussi

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