String.Trim Méthode

Référence

Définition

Espace de noms:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Retourne une nouvelle chaîne dans laquelle toutes les occurrences d’un jeu de caractères spécifique sont supprimées au début et à la fin de la chaîne actuelle.

Surcharges

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

Trim()

Source:: String.Manipulation.cs

Source:: String.Manipulation.cs

Source:: String.Manipulation.cs

Supprime tous les caractères correspondant à un espace blanc au début et à la fin de la chaîne actuelle.

public:
 System::String ^ Trim();

public string Trim ();

member this.Trim : unit -> string

Public Function Trim () As String

Retours

String

Chaîne restante après la suppression de tous les espaces blancs de début et de 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.

Exemples

L’exemple suivant utilise la String.Trim() méthode pour supprimer tout espace blanc supplémentaire des chaînes entrées par l’utilisateur avant de les concaténer.

using namespace System;

void main()
{
   Console::Write("Enter your first name: ");
   String^ firstName = Console::ReadLine();
   
   Console::Write("Enter your middle name or initial: ");
   String^ middleName = Console::ReadLine();
   
   Console::Write("Enter your last name: ");
   String^ lastName = Console::ReadLine();
   
   Console::WriteLine();
   Console::WriteLine("You entered '{0}', '{1}', and '{2}'.",
                      firstName, middleName, lastName);
   
   String^ name = ((firstName->Trim() + " " + middleName->Trim())->Trim() + " " +
                  lastName->Trim())->Trim();
   Console::WriteLine("The result is " + name + ".");
}
// The following is possible output from this example:
//       Enter your first name:    John
//       Enter your middle name or initial:
//       Enter your last name:    Doe
//       
//       You entered '   John  ', '', and '   Doe'.
//       The result is John Doe.

using System;

public class Example
{
    public static void Main()
    {
        Console.Write("Enter your first name: ");
        string firstName = Console.ReadLine();
      
        Console.Write("Enter your middle name or initial: ");
        string middleName = Console.ReadLine();
      
        Console.Write("Enter your last name: ");
        string lastName = Console.ReadLine();
      
        Console.WriteLine();
        Console.WriteLine("You entered '{0}', '{1}', and '{2}'.", 
                        firstName, middleName, lastName);
      
        string name = ((firstName.Trim() + " " + middleName.Trim()).Trim() + " " + 
                    lastName.Trim()).Trim();
        Console.WriteLine("The result is " + name + ".");

        // The following is a possible output from this example:
        //       Enter your first name:    John
        //       Enter your middle name or initial:
        //       Enter your last name:    Doe
        //       
        //       You entered '   John  ', '', and '   Doe'.
        //       The result is John Doe.
    }
}

printf "Enter your first name: "
let firstName = stdin.ReadLine()

printf "Enter your middle name or initial: "
let middleName = stdin.ReadLine()

printf "Enter your last name: "
let lastName = stdin.ReadLine()

printfn $"\nYou entered '{firstName}', '{middleName}', and '{lastName}'." 

let name = ((firstName.Trim() + " " + middleName.Trim()).Trim() + " " + lastName.Trim()).Trim()
printfn $"The result is {name}."

// The following is a possible output from this example:
//       Enter your first name:    John
//       Enter your middle name or initial:
//       Enter your last name:    Doe
//       
//       You entered '   John  ', '', and '   Doe'.
//       The result is John Doe.

Module Example
   Public Sub Main()
      Console.Write("Enter your first name: ")
      Dim firstName As String = Console.ReadLine()
      
      Console.Write("Enter your middle name or initial: ")
      Dim middleName As String = Console.ReadLine()
      
      Console.Write("Enter your last name: ")
      Dim lastName As String = Console.ReadLine
      
      Console.WriteLine()
      Console.WriteLine("You entered '{0}', '{1}', and '{2}'.", _
                        firstName, middleName, lastName)
                        
      Dim name As String = ((firstName.Trim() + " " + middleName.Trim()).Trim() _
                           + " " + lastName.Trim()).Trim()                        
      Console.WriteLine("The result is " + name + ".")
   End Sub
End Module
' The following is possible output from this example:
'       Enter your first name:    John
'       Enter your middle name or initial:
'       Enter your last name:    Doe
'       
'       You entered '   John  ', '', and '   Doe'.
'       The result is John Doe.

Remarques

La Trim méthode supprime de la chaîne actuelle tous les caractères d’espace blanc de début et de fin. Chaque opération de découpage de début et de fin s’arrête lorsqu’un caractère non-espace blanc est rencontré. Par exemple, si la chaîne actuelle est « abc xyz », la Trim méthode retourne « abc xyz ». Pour supprimer des espaces blancs entre des mots d’une chaîne, utilisez expressions régulières .NET.

Notes

Si la Trim 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 début et de fin trouvés dans le instance actuel sont supprimés.

Si la chaîne actuelle est égale Empty ou que tous les caractères de la instance actuelle se composent de caractères d’espace blanc, la méthode retourne Empty.

Les espaces blancs sont définis par la norme Unicode. La Trim méthode supprime tous les caractères de début et de fin qui produisent une valeur de retour de true lorsqu’ils sont passés à la Char.IsWhiteSpace méthode.

Notes pour les appelants

Le .NET Framework 3.5 SP1 et les versions antérieures conservent une liste interne d’espaces blancs que cette méthode rognera. À compter de .NET Framework 4, 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

S’applique à

Trim(Char[])

Source:: String.Manipulation.cs

Source:: String.Manipulation.cs

Source:: String.Manipulation.cs

Supprime toutes les occurrences du jeu de caractères spécifié dans un tableau au début et à la fin de la chaîne actuelle.

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

public string Trim (params char[] trimChars);

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

member this.Trim : char[] -> string

Public Function Trim (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 du début et de la fin de la chaîne actuelle. Si trimChars est null ou est un tableau vide, les espaces blancs sont plutôt 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 utilise la Trim(System.Char[]) méthode pour supprimer des caractères d’espace, d’astérisque (*) et d’apostrophe (') d’une chaîne.

using namespace System;

void main()
{
   array<Char>^ charsToTrim = { L'*', L' ', L'\\' };
   String^ banner = "*** Much Ado About Nothing ***";
   String^ result = banner->Trim(charsToTrim);
   Console::WriteLine("Trimmmed\n   {0}\nto\n   '{1}'", banner, result);
}
// The example displays the following output:
//       Trimmmed
//          *** Much Ado About Nothing ***
//       to
//          'Much Ado About Nothing'

char[] charsToTrim = { '*', ' ', '\''};
string banner = "*** Much Ado About Nothing ***";
string result = banner.Trim(charsToTrim);
Console.WriteLine("Trimmed\n   {0}\nto\n   '{1}'", banner, result);

// The example displays the following output:
//       Trimmed
//          *** Much Ado About Nothing ***
//       to
//          'Much Ado About Nothing'

let charsToTrim = [| '*'; ' '; '\'' |]
let banner = "*** Much Ado About Nothing ***"
let result = banner.Trim charsToTrim
printfn $"Trimmmed\n   {banner}\nto\n   '{result}'"

// The example displays the following output:
//       Trimmmed
//          *** Much Ado About Nothing ***
//       to
//          'Much Ado About Nothing'

Module Example
   Public Sub Main()
      Dim charsToTrim() As Char = { "*"c, " "c, "'"c}
      Dim banner As String = "*** Much Ado About Nothing ***"
      Dim result As String = banner.Trim(charsToTrim)
      Console.WriteLine("Trimmmed{0}   {1}{0}to{0}   '{2}'", _
                        vbCrLf, banner, result)
   End Sub
End Module
' The example displays the following output:
'       Trimmmed
'          *** Much Ado About Nothing ***
'       to
'          'Much Ado About Nothing'

Remarques

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

Notes

Si la Trim(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 début et de trimChars fin trouvés dans le instance actuel sont supprimés.

Si la chaîne actuelle est égale Empty ou si tous les caractères du instance actuel se composent de caractères dans le trimChars tableau, la méthode retourne Empty.

Si trimChars est null ou un tableau vide, cette méthode supprime tous les caractères de début ou de fin qui entraînent le retour true de la méthode lorsqu’ils sont passés à la Char.IsWhiteSpace méthode.

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

S’applique à

Trim(Char)

Source:: String.Manipulation.cs

Source:: String.Manipulation.cs

Source:: String.Manipulation.cs

Supprime toutes les instances d’un caractère au début et à la fin de la chaîne actuelle.

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

public string Trim (char trimChar);

member this.Trim : char -> string

Public Function Trim (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 instances du caractère trimChar au début et à 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 Trim(System.Char) méthode supprime de la chaîne actuelle toutes les instances de début et de fin du trimChar caractère. Chaque opération de découpage de début et de fin s’arrête lorsqu’un caractère différent de trimChar est rencontré. Par exemple, si trimChar est - et que la chaîne actuelle est « ---abc---xyz---- », la Trim(System.Char) méthode retourne « abc---xyz ». Pour supprimer des caractères entre les mots d’une chaîne, utilisez expressions régulières .NET.

Notes

Si la Trim(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 début et de trimChar fin trouvés dans le instance actuel sont supprimés.

Si la chaîne actuelle est égale ou si tous les caractères du instance actuel sont constitués Empty de trimChar caractères, la méthode retourne Empty.

S’applique à

String.Trim Méthode

Définition

Surcharges

Trim()

Retours

Exemples

Remarques

Notes pour les appelants

Voir aussi

S’applique à

Trim(Char[])

Paramètres

Retours

Exemples

Remarques

Notes pour les appelants

Voir aussi

S’applique à

Trim(Char)

Paramètres

Retours

Remarques

S’applique à

Commentaires

Ressources supplémentaires