String.TrimEnd Méthode

Définition

Surcharges

TrimEnd(Char[])

Supprime toutes les occurrences du jeu de caractères spécifié dans un tableau à la fin de la chaîne actuelle.Removes all the trailing occurrences of a set of characters specified in an array from the current string.

TrimEnd(Char)

Supprime toutes les occurrences d’un caractère à la fin de la chaîne actuelle.Removes all the trailing occurrences of a character from the current string.

TrimEnd()

Supprime tous les caractères correspondant à un espace blanc à la fin de la chaîne actuelle.Removes all the trailing white-space characters from the current string.

TrimEnd(Char[])

Supprime toutes les occurrences du jeu de caractères spécifié dans un tableau à la fin de la chaîne actuelle.Removes all the trailing occurrences of a set of characters specified in an array from the current string.

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.An array of Unicode characters to remove, or null.

Retours

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.The string that remains after all occurrences of the characters in the trimChars parameter are removed from the end of the current string. Si trimChars est null ou un tableau vide, ce sont les espaces blancs Unicode qui sont supprimés.If trimChars is null or an empty array, Unicode white-space characters are removed instead. Si aucun caractère ne peut être tronqué dans l'instance active, la méthode retourne l'instance active inchangée.If no characters can be trimmed from the current instance, the method returns the current instance unchanged.

Exemples

L’exemple suivant montre comment vous pouvez utiliser la méthode TrimEnd(System.Char[]) pour supprimer les espaces blancs ou les signes de ponctuation à la fin d’une chaîne.The following example demonstrates how you can use the TrimEnd(System.Char[]) method to trim white space or punctuation marks from the end of a string.

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
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 qui se trouvent dans le paramètre trimChars.The TrimEnd(System.Char[]) method removes from the current string all trailing characters that are in the trimChars parameter. L’opération de suppression s’arrête lorsque le premier caractère qui n’est pas dans trimChars est rencontré à la fin de la chaîne.The trim operation stops when the first character that is not in trimChars is encountered at the end of the string. 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 ».For example, if the current string is "123abc456xyz789" and trimChars contains the digits from "1" through "9", the TrimEnd(System.Char[]) method returns "123abc456xyz".

Notes

Si la méthode TrimEnd(System.Char[]) supprime tous les caractères de l’instance actuelle, cette méthode ne modifie pas la valeur de l’instance actuelle.If the TrimEnd(System.Char[]) method removes any characters from the current instance, this method does not modify the value of the current instance. 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.Instead, it returns a new string in which all trailing characters found in trimChars are removed from the current string.

Notes pour les appelants

La .NET Framework 3.5 SP1.NET Framework 3.5 SP1 et les versions antérieures maintiennent une liste interne d’espaces blancs que cette méthode tronque si trimChars est null ou un tableau vide.The .NET Framework 3.5 SP1.NET Framework 3.5 SP1 and earlier versions maintains an internal list of white-space characters that this method trims if trimChars is null or an empty array. À partir de la .NET Framework 4.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’ils sont passés à la méthode IsWhiteSpace(Char)).Starting with the .NET Framework 4.NET Framework 4, if trimChars is null or an empty array, the method trims all Unicode white-space characters (that is, characters that produce a true return value when they are passed to the IsWhiteSpace(Char) method). En raison de cette modification, la méthode Trim() dans le .NET Framework 3.5 SP1.NET Framework 3.5 SP1 et les versions antérieures supprime deux caractères, l’espace de largeur zéro (U + 200B) et l’espace de non-saut de largeur zéro (U + FEFF), que la méthode Trim() dans le .NET Framework 4.NET Framework 4 et versions ultérieures ne supprime pas.Because of this change, the Trim() method in the .NET Framework 3.5 SP1.NET Framework 3.5 SP1 and earlier versions removes two characters, ZERO WIDTH SPACE (U+200B) and ZERO WIDTH NO-BREAK SPACE (U+FEFF), that the Trim() method in the .NET Framework 4.NET Framework 4 and later versions does not remove. En outre, la méthode Trim() dans les versions .NET Framework 3.5 SP1.NET Framework 3.5 SP1 et antérieures ne supprime pas trois espaces blancs Unicode : séparateur de voyelle mongole (U + 180E), espace insécable étroit (U + 202F) et espace mathématique moyen mathématique (U + 205F).In addition, the Trim() method in the .NET Framework 3.5 SP1.NET Framework 3.5 SP1 and earlier versions does not trim three Unicode white-space characters: MONGOLIAN VOWEL SEPARATOR (U+180E), NARROW NO-BREAK SPACE (U+202F), and MEDIUM MATHEMATICAL SPACE (U+205F).

Voir aussi

TrimEnd(Char)

Supprime toutes les occurrences d’un caractère à la fin de la chaîne actuelle.Removes all the trailing occurrences of a character from the current string.

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.A Unicode character to remove.

Retours

Chaîne restante après la suppression de toutes les occurrences du caractère trimChar à la fin de la chaîne actuelle.The string that remains after all occurrences of the trimChar character are removed from the end of the current string. Si aucun caractère ne peut être tronqué dans l'instance active, la méthode retourne l'instance active inchangée.If no characters can be trimmed from the current instance, the method returns the current instance unchanged.

Remarques

La méthode TrimEnd(System.Char) supprime de la chaîne actuelle tous les caractères de trimChar de fin.The TrimEnd(System.Char) method removes from the current string all trailing trimChar characters. L’opération de suppression s’arrête lorsque le premier caractère qui n’est pas trimChar est rencontré à la fin de la chaîne.The trim operation stops when the first character that is not trimChar is encountered at the end of the string. Par exemple, si trimChar est - et que la chaîne actuelle est « ---ABC---XYZ---- », la méthode TrimEnd(System.Char) renvoie « ---ABC---XYZ ».For example, if trimChar is - and the current string is "---abc---xyz----", the TrimEnd(System.Char) method returns "---abc---xyz".

Notes

Si la méthode TrimEnd(System.Char) supprime tous les caractères de l’instance actuelle, cette méthode ne modifie pas la valeur de l’instance actuelle.If the TrimEnd(System.Char) method removes any characters from the current instance, this method does not modify the value of the current instance. Au lieu de cela, elle retourne une nouvelle chaîne dans laquelle tous les caractères de trimChar de fin sont supprimés de la chaîne actuelle.Instead, it returns a new string in which all trailing trimChar characters are removed from the current string.

TrimEnd()

Supprime tous les caractères correspondant à un espace blanc à la fin de la chaîne actuelle.Removes all the trailing white-space characters from the current string.

public:
 System::String ^ TrimEnd();
public string TrimEnd ();
member this.TrimEnd : unit -> string
Public Function TrimEnd () As String

Retours

Chaîne restante après la suppression de tous les caractères correspondant à un espace blanc à la fin de la chaîne actuelle.The string that remains after all white-space characters are removed from the end of the current string. Si aucun caractère ne peut être tronqué dans l'instance active, la méthode retourne l'instance active inchangée.If no characters can be trimmed from the current instance, the method returns the current instance unchanged.

Remarques

La méthode TrimEnd supprime de la chaîne actuelle tous les espaces blancs de fin.The TrimEnd method removes from the current string all trailing white-space characters. L’opération de suppression s’arrête lorsque le premier caractère autre qu’un espace blanc est rencontré à la fin de la chaîne.The trim operation stops when the first non white-space character is encountered at the end of the string. Par exemple, si la chaîne actuelle est « ABC XYZ », la TrimEnd méthode retourne « ABC XYZ ».For example, if the current string is " abc xyz ", the TrimEnd method returns " abc xyz".

Notes

Si la méthode TrimEnd supprime tous les caractères de l’instance actuelle, cette méthode ne modifie pas la valeur de l’instance actuelle.If the TrimEnd method removes any characters from the current instance, this method does not modify the value of the current instance. 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.Instead, it returns a new string in which all trailing white-space characters are removed from the current string.

S’applique à