String.Trim Methode

Definition

Gibt eine neue Zeichenfolge zurück, in der alle führenden und nachfolgenden Vorkommen einer Reihe von angegebenen Zeichen aus der aktuellen Zeichenfolge entfernt werden.

Überlädt

Trim(Char)

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

Trim(ReadOnlySpan<Char>)

Entfernt alle führenden und nachfolgenden Vorkommen einer Reihe von Zeichen, die in einer Spanne von der aktuellen Zeichenfolge angegeben sind.

Trim()

Entfernt alle führenden und nachfolgenden Leerzeichen aus der aktuellen Zeichenfolge.

Trim(Char[])

Entfernt alle führenden und nachgestellten Vorkommen einer Reihe von Zeichen, die in einem Array aus der aktuellen Zeichenfolge angegeben sind.

Trim(Char)

Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs

Entfernt alle führenden und nachfolgenden 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 entfernenes Unicode-Zeichen.

Gibt zurück

Die Zeichenfolge, die verbleibt, nachdem alle Instanzen des trimChar Zeichens vom Anfang und Ende der aktuellen Zeichenfolge entfernt wurden. Wenn keine Zeichen von 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 nachfolgenden Instanzen des trimChar Zeichens. Jeder führende und nachfolgende Kürzungsvorgang stoppt, wenn ein zeichen anders als trimChar gefunden wird. Wenn trimChar beispielsweise - ist und die aktuelle Zeichenfolge "---abc---xyz----" lautet, gibt die Trim(System.Char)-Methode "abc---xyz" zurück. Um Zeichen zwischen Wörtern in einer Zeichenfolge zu entfernen, verwenden Sie .NET Regular Expressions.

Anmerkung

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

Wenn die aktuelle Zeichenfolge Empty oder alle Zeichen in der aktuellen Instanz aus trimChar Zeichen besteht, gibt die Methode Emptyzurück.

Gilt für:

Trim(ReadOnlySpan<Char>)

Entfernt alle führenden und nachfolgenden Vorkommen einer Reihe von Zeichen, die in einer Spanne von der aktuellen Zeichenfolge angegeben sind.

public:
 System::String ^ Trim(ReadOnlySpan<char> trimChars);
public string Trim (scoped ReadOnlySpan<char> trimChars);
member this.Trim : ReadOnlySpan<char> -> string
Public Function Trim (trimChars As ReadOnlySpan(Of Char)) As String

Parameter

trimChars
ReadOnlySpan<Char>

Eine Spanne von Unicode-Zeichen, die entfernt werden sollen.

Gibt zurück

Die Zeichenfolge, die nach allen Vorkommen der Zeichen im parameter trimChars verbleibt, wird vom Anfang und Ende der aktuellen Zeichenfolge entfernt. Wenn trimChars leer ist, werden stattdessen Leerzeichen entfernt. Wenn keine Zeichen von der aktuellen Instanz gekürzt werden können, gibt die Methode die aktuelle Instanz unverändert zurück.

Gilt für:

Trim()

Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs

Entfernt alle führenden und nachfolgenden Leerzeichen 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 Zeichenfolge, die verbleibt, nachdem alle Leerzeichen vom Anfang und Ende der aktuellen Zeichenfolge entfernt wurden. Wenn keine Zeichen von 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 wurden, 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 aus der aktuellen Zeichenfolge alle führenden und nachfolgenden Leerzeichen. Jeder führende und nachfolgende Kürzungsvorgang wird beendet, wenn ein Nicht-Leerzeichen gefunden wird. Wenn die aktuelle Zeichenfolge beispielsweise "abc xyz" lautet, gibt die Trim-Methode "abc xyz" zurück. Um Leerzeichen zwischen Wörtern in einer Zeichenfolge zu entfernen, verwenden Sie .NET Regular Expressions.

Anmerkung

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

Wenn die aktuelle Zeichenfolge Empty oder alle Zeichen in der aktuellen Instanz aus Leerzeichen besteht, gibt die Methode Emptyzurück.

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

Hinweise für Aufrufer

Mit .NET Framework 3.5 SP1 und früheren Versionen wird eine interne Liste von Leerzeichen verwaltet, die von dieser Methode gekürzt werden. Ab .NET Framework 4 schneidet die Methode alle Unicode-Leerzeichen ab (d. h. Zeichen, die einen true Rückgabewert erzeugen, wenn sie an die IsWhiteSpace(Char)-Methode übergeben werden). Aufgrund dieser Änderung entfernt die Trim()-Methode in .NET Framework 3.5 SP1 und früheren Versionen zwei Zeichen, NULL WIDTH SPACE (U+200B) und NULL WIDTH NO-BREAK SPACE (U+FEFF), die die Trim()-Methode in .NET Framework 4 und höheren Versionen nicht entfernt. Darüber hinaus werden mit der Trim()-Methode in .NET Framework 3.5 SP1 und früheren Versionen drei Unicode-Leerzeichen nicht gekürzt: MONGOLN VOWEL SEPARATOR (U+180E), NARROW NO-BREAK SPACE (U+202F) und MITTLERE MATHEMATISCHE LEERZEICHEN (U+205F).

Weitere Informationen

Gilt für:

Trim(Char[])

Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs

Entfernt alle führenden und nachgestellten Vorkommen einer Reihe von Zeichen, die in einem Array aus der aktuellen Zeichenfolge angegeben sind.

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 von Unicode-Zeichen, die entfernt werden sollen, oder null.

Gibt zurück

Die Zeichenfolge, die nach allen Vorkommen der Zeichen im parameter trimChars verbleibt, wird vom Anfang und Ende der aktuellen Zeichenfolge entfernt. Wenn trimCharsnull oder ein leeres Array ist, werden stattdessen Leerzeichen entfernt. Wenn keine Zeichen von 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 sich im trimChars-Parameter befinden. Jeder führende und nachfolgende Kürzungsvorgang wird beendet, wenn ein Zeichen, das sich nicht in trimChars befindet, gefunden wird. 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.

Anmerkung

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

Wenn die aktuelle Zeichenfolge Empty oder alle Zeichen in der aktuellen Instanz aus Zeichen im trimChars Array besteht, gibt die Methode Emptyzurück.

Wenn trimCharsnull oder ein leeres Array ist, entfernt diese Methode führende oder nachfolgende Zeichen, die dazu führen, dass die Methode true zurückgibt, wenn sie an die Char.IsWhiteSpace Methode übergeben werden.

Hinweise für Aufrufer

In .NET Framework 3.5 SP1 und früheren Versionen wird eine interne Liste von Leerzeichen verwaltet, die von dieser Methode gekürzt werden, wenn trimCharsnull oder ein leeres Array ist. Ab .NET Framework 4 werden bei trimCharsnull oder einem leeren Array alle Unicode-Leerzeichen gekürzt (d. h. Zeichen, die einen true Rückgabewert erzeugen, wenn sie an die IsWhiteSpace(Char) Methode übergeben werden). Aufgrund dieser Änderung entfernt die Trim()-Methode in .NET Framework 3.5 SP1 und früheren Versionen zwei Zeichen, NULL WIDTH SPACE (U+200B) und NULL WIDTH NO-BREAK SPACE (U+FEFF), die die Trim() Methode in .NET Framework 4 und späteren Versionen nicht entfernt. Darüber hinaus werden mit der Trim()-Methode in .NET Framework 3.5 SP1 und früheren Versionen drei Unicode-Leerzeichen nicht gekürzt: MONGOLN VOWEL SEPARATOR (U+180E), NARROW NO-BREAK SPACE (U+202F) und MITTLERE MATHEMATISCHE LEERZEICHEN (U+205F).

Weitere Informationen

Gilt für: