Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

String.TrimEnd méthode (Char[])

 

Date de publication : novembre 2016

Supprime, de l'objet String actuel, toutes les occurrences situées à la fin d'un jeu de caractères spécifiés dans un tableau.

Espace de noms:   System
Assembly:  mscorlib (dans mscorlib.dll)

public string TrimEnd(
	params char[] trimChars
)

Paramètres

trimChars
Type: System.Char[]

Tableau de caractères Unicode à supprimer, ou null.

Valeur de retour

Type: System.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.

Le TrimEnd 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 suppression s’arrête quand le premier caractère qui n’est pas trimChars est rencontré à la fin de la chaîne. Par exemple, si la chaîne actuelle est « 123abc456xyz789 » et trimChars contient les chiffres à partir de « 1 » à « 9 », le TrimEnd méthode retourne « 123abc456xyz ».

System_CAPS_noteRemarque

Si le TrimEnd méthode supprime tous les caractères à partir de l’instance actuelle, cette méthode ne modifie pas la valeur de l’instance actuelle. Au lieu de cela, il retourne une nouvelle chaîne dans laquelle tous les caractères trouvés dans trimChars sont supprimés de la chaîne actuelle.

Remarques à l’attention des appelants :

Le .NET Framework 3.5 SP1 et les versions antérieures conserve une liste interne d’espaces blancs que cette méthode supprime si trimChars est null ou un tableau vide. En commençant par le .NET Framework 4, si trimChars est null ou un tableau vide, la méthode supprime tous les caractères d’espaces blancs Unicode (autrement dit, les caractères qui produisent une true valeur de retour lorsqu’ils sont passés à la Char.IsWhiteSpace (méthode)). Grâce à cette modification, le Trim() méthode dans le .NET Framework 3.5 SP1 et versions antérieures, supprime deux caractères, ZERO WIDTH SPACE (U + 200 b) et la largeur d’espace insécable (U + FEFF), zéro qui le Trim() méthode dans le .NET Framework 4 et ne supprime pas les versions ultérieures. En outre, le Trim() méthode dans le .NET Framework 3.5 SP1 et les versions antérieures ne les supprime trois caractères d’espaces blancs Unicode : séparateur de voyelle en MONGOL (U + 180E), espace insécable étroite (U + 202F) et espace moyenne mathématique (U + 205F).

L’exemple suivant montre comment vous pouvez utiliser la TrimEnd(Char[]) méthode pour supprimer un espace blanc ou les marques de ponctuation à la fin d’une chaîne.

using System;

public class TrimEnd
{
   public static void Main()
   {
      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

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 1.1
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: