String.Trim Methode

Definition

Gibt eine neue Zeichenfolge zurück, in der alle führenden und nachgestellten Vorkommen einer Gruppe von angegebenen Zeichen aus der aktuellen Zeichenfolge entfernt wurden.

Überlädt

Trim()

Entfernt alle führenden und nachgestellten Leerraumzeichen aus der aktuellen Zeichenfolge.

Trim(Char[])

Entfernt alle führenden und nachgestellten Vorkommen der Zeichen im angegebenen Array aus der aktuellen Zeichenfolge.

Trim(Char)

Entfernt alle führenden und nachgestellten Instanzen eines Zeichens aus der aktuellen Zeichenfolge.

Trim()

Entfernt alle führenden und nachgestellten Leerraumzeichen aus der aktuellen Zeichenfolge.

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

Gibt zurück

Die resultierende Zeichenfolge nach dem Entfernen alle Leerraumzeichen am Anfang und Ende der aktuellen Zeichenfolge. Wenn keine Zeichen in der aktuellen Instanz gekürzt werden können, gibt die Methode die aktuelle Instanz unverändert zurück.

Beispiele

Im folgenden Beispiel wird die String.Trim() -Methode verwendet, um zusätzliche Leerzeichen aus Zeichenfolgen zu entfernen, die vom Benutzer eingegeben werden, bevor sie verkettet werden.

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.

Hinweise

Die Trim -Methode entfernt alle führenden und nachfolgenden Leerzeichen aus der aktuellen Zeichenfolge. Jeder führende und nachfolgende Kürzungsvorgang wird beendet, wenn ein Zeichen ohne Leerzeichen gefunden wird. Wenn die aktuelle Zeichenfolge beispielsweise "abc xyz" lautet, gibt die Trim Methode "abc xyz" zurück. Verwenden Sie reguläre .NET-Ausdrücke, um Leerzeichen zwischen Wörtern in einer Zeichenfolge zu entfernen.

Hinweis

Wenn die Trim -Methode Zeichen aus dem aktuellen instance entfernt, ändert diese Methode nicht den Wert der aktuellen instance. Stattdessen wird eine neue Zeichenfolge zurückgegeben, in der alle führenden und nachfolgenden Leerzeichen im aktuellen instance entfernt werden.

Wenn die aktuelle Zeichenfolge gleich Empty ist oder alle Zeichen im aktuellen instance aus Leerzeichen bestehen, gibt die -Methode zurückEmpty.

Leerzeichen werden durch den Unicode-Standard definiert. Die Trim -Methode entfernt alle führenden und nachfolgenden Zeichen, die einen Rückgabewert von true erzeugen, wenn sie an die Char.IsWhiteSpace -Methode übergeben werden.

Hinweise für Aufrufer

Die .NET Framework 3.5 SP1 und früheren Versionen verwalten eine interne Liste von Leerzeichen, die diese Methode schneidet. Ab dem .NET Framework 4 schneidet die Methode alle Unicode-Leerzeichen ab (d. a. Zeichen, die einen true Rückgabewert erzeugen, wenn sie an die IsWhiteSpace(Char) -Methode übergeben werden). Aufgrund dieser Änderung entfernt die Trim() -Methode im .NET Framework 3.5 SP1 und früheren Versionen zwei Zeichen, ZERO WIDTH SPACE (U+200B) und ZERO WIDTH NO-BREAK SPACE (U+FEFF), die von der Trim() -Methode im .NET Framework 4und höheren Versionen nicht entfernt werden. Darüber hinaus schneidet die Trim() -Methode im .NET Framework 3.5 SP1 und früheren Versionen drei Unicode-Leerzeichen nicht ab: MONGOLIAN VOWEL SEPARATOR (U+180E), NARROW NO-BREAK SPACE (U+202F) und MEDIUM MATHEMATICAL SPACE (U+205F).

Weitere Informationen

Gilt für:

Trim(Char[])

Entfernt alle führenden und nachgestellten Vorkommen der Zeichen im angegebenen Array aus der aktuellen Zeichenfolge.

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

Parameter

trimChars
Char[]

Ein Array mit den zu entfernenden Unicode-Zeichen oder null.

Gibt zurück

Die resultierende Zeichenfolge, nachdem alle im trimChars-Parameter übergebenen Zeichen am Anfang und Ende der aktuellen Zeichenfolge entfernt wurden. Wenn trimCharsnull oder ein leeres Array ist, werden stattdessen Leerzeichen entfernt. Wenn keine Zeichen in der aktuellen Instanz gekürzt werden können, gibt die Methode die aktuelle Instanz unverändert zurück.

Beispiele

Im folgenden Beispiel wird die Trim(System.Char[]) -Methode verwendet, um Leerzeichen, Sternchen (*) und Apostroph (')-Zeichen aus einer Zeichenfolge zu entfernen.

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'

Hinweise

Die Trim(System.Char[]) -Methode entfernt aus der aktuellen Zeichenfolge alle führenden und nachfolgenden Zeichen, die trimChars sich im Parameter befinden. Jeder führende und nachfolgende Kürzungsvorgang wird beendet, wenn ein Zeichen gefunden wird, das nicht in trimChars ist. Wenn die aktuelle Zeichenfolge beispielsweise "123abc456xyz789" lautet und trimChars die Ziffern von "1" bis "9" enthält, gibt die Trim(System.Char[]) Methode "abc456xyz" zurück.

Hinweis

Wenn die Trim(System.Char[]) -Methode Zeichen aus dem aktuellen instance entfernt, ändert diese Methode nicht den Wert der aktuellen instance. Stattdessen wird eine neue Zeichenfolge zurückgegeben, in der alle führenden und nachfolgenden trimChars Zeichen aus dem aktuellen instance entfernt werden.

Wenn die aktuelle Zeichenfolge gleich Empty ist oder alle Zeichen im aktuellen instance aus Zeichen im trimChars Array bestehen, gibt die -Methode zurückEmpty.

Wenn trimChars ein leeres Array ist null , entfernt diese Methode alle führenden oder nachgestellten Zeichen, die dazu führen, dass die Methode zurückgegeben true wird, wenn sie an die Char.IsWhiteSpace Methode übergeben werden.

Hinweise für Aufrufer

Der .NET Framework 3.5 SP1 und früheren Versionen verwaltet eine interne Liste von Leerzeichen, die diese Methode abschneidet, wenn trimChars ein leeres Array istnull. Ab dem .NET Framework 4, wenn trimChars oder ein leeres Array istnull, schneidet die -Methode alle Unicode-Leerzeichen (d. a. Zeichen, die einen true Rückgabewert erzeugen, wenn sie an die IsWhiteSpace(Char) -Methode übergeben werden). Aufgrund dieser Änderung entfernt die Trim() -Methode im .NET Framework 3.5 SP1 und früheren Versionen zwei Zeichen, ZERO WIDTH SPACE (U+200B) und ZERO WIDTH NO-BREAK SPACE (U+FEFF), die von der Trim() -Methode im .NET Framework 4und höheren Versionen nicht entfernt werden. Darüber hinaus schneidet die Trim() -Methode im .NET Framework 3.5 SP1 und früheren Versionen drei Unicode-Leerzeichen nicht ab: MONGOLIAN VOWEL SEPARATOR (U+180E), NARROW NO-BREAK SPACE (U+202F) und MEDIUM MATHEMATICAL SPACE (U+205F).

Weitere Informationen

Gilt für:

Trim(Char)

Entfernt alle führenden und nachgestellten Instanzen eines Zeichens aus der aktuellen Zeichenfolge.

public:
 System::String ^ Trim(char trimChar);
public string Trim (char trimChar);
member this.Trim : char -> string
Public Function Trim (trimChar As Char) As String

Parameter

trimChar
Char

Ein zu entfernendes Unicode-Zeichen.

Gibt zurück

Die resultierende Zeichenfolge nach dem Entfernen aller Instanzen des Zeichen trimChar am Anfang und Ende der aktuellen Zeichenfolge. Wenn keine Zeichen in der aktuellen Instanz gekürzt werden können, gibt die Methode die aktuelle Instanz unverändert zurück.

Hinweise

Die Trim(System.Char) -Methode entfernt aus der aktuellen Zeichenfolge alle führenden und nachgestellten Instanzen des trimChar Zeichens. Jeder führende und nachfolgende Kürzungsvorgang wird beendet, wenn ein anderes Zeichen als trimChar gefunden wird. Wenn beispielsweise trimChar ist - und die aktuelle Zeichenfolge "---abc---xyz----" lautet, gibt die Trim(System.Char) Methode "abc---xyz" zurück. Verwenden Sie reguläre .NET-Ausdrücke, um Zeichen zwischen Wörtern in einer Zeichenfolge zu entfernen.

Hinweis

Wenn die Trim(System.Char) -Methode Zeichen aus dem aktuellen instance entfernt, ändert diese Methode nicht den Wert der aktuellen instance. Stattdessen wird eine neue Zeichenfolge zurückgegeben, in der alle führenden und nachfolgenden trimChar Zeichen aus dem aktuellen instance entfernt werden.

Wenn die aktuelle Zeichenfolge gleich ist Empty oder alle Zeichen im aktuellen instance aus Zeichen bestehentrimChar, gibt die -Methode zurückEmpty.

Gilt für: