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.Returns a new string in which all leading and trailing occurrences of a set of specified characters from the current string are removed.

Überlädt

Trim(Char[])

Entfernt alle führenden und nachgestellten Vorkommen der Zeichen im angegebenen Array aus der aktuellen Zeichenfolge.Removes all leading and trailing occurrences of a set of characters specified in an array from the current string.

Trim(Char)

Entfernt alle führenden und nachgestellten Instanzen eines Zeichens aus der aktuellen Zeichenfolge.Removes all leading and trailing instances of a character from the current string.

Trim()

Entfernt alle führenden und nachgestellten Leerraumzeichen aus der aktuellen Zeichenfolge.Removes all leading and trailing white-space characters from the current string.

Trim(Char[])

Entfernt alle führenden und nachgestellten Vorkommen der Zeichen im angegebenen Array aus der aktuellen Zeichenfolge.Removes all leading and trailing occurrences of a set of characters specified in an array from the current string.

public:
 System::String ^ Trim(... cli::array <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.An array of Unicode characters to remove, or null.

Gibt zurück

Die resultierende Zeichenfolge, nachdem alle im trimChars-Parameter übergebenen Zeichen am Anfang und Ende der aktuellen Zeichenfolge entfernt wurden.The string that remains after all occurrences of the characters in the trimChars parameter are removed from the start and end of the current string. Wenn trimChars null oder ein leeres Array ist, werden stattdessen Leerzeichen entfernt.If trimChars is null or an empty array, white-space characters are removed instead. Wenn keine Zeichen in der aktuellen Instanz gekürzt werden können, gibt die Methode die aktuelle Instanz unverändert zurück.If no characters can be trimmed from the current instance, the method returns the current instance unchanged.

Beispiele

Im folgenden Beispiel werden die Trim(System.Char[])-Methode verwendet, um Leerzeichen, Sternchen (*) und Apostroph (') aus einer Zeichenfolge zu entfernen.The following example uses the Trim(System.Char[]) method to remove space, asterisk (*), and apostrophe (') characters from a string.

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("Trimmmed\n   {0}\nto\n   '{1}'", banner, 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 alle führenden und nachfolgenden Zeichen aus der aktuellen Zeichenfolge, die im trimChars-Parameter enthalten sind.The Trim(System.Char[]) method removes from the current string all leading and trailing characters that are in the trimChars parameter. Jeder führende und nachfolgende Trim-Vorgang wird beendet, wenn ein Zeichen, das sich nicht in trimChars befindet, gefunden wird.Each leading and trailing trim operation stops when a character that is not in trimChars is encountered. Wenn die aktuelle Zeichenfolge z. b. "123abc456xyz789" ist und trimChars die Ziffern von "1" bis "9" enthält, gibt die Trim(System.Char[])-Methode "abc456xyz" zurück.For example, if the current string is "123abc456xyz789" and trimChars contains the digits from "1" through "9", the Trim(System.Char[]) method returns "abc456xyz".

Hinweis

Wenn die Trim(System.Char[])-Methode alle Zeichen aus der aktuellen Instanz entfernt, ändert diese Methode nicht den Wert der aktuellen Instanz.If the Trim(System.Char[]) method removes any characters from the current instance, this method does not modify the value of the current instance. Stattdessen wird eine neue Zeichenfolge zurückgegeben, in der alle führenden und nachfolgenden trimChars Zeichen, die in der aktuellen Instanz gefunden werden, entfernt werden.Instead, it returns a new string in which all leading and trailing trimChars characters found in the current instance are removed.

Wenn die aktuelle Zeichenfolge Empty ist oder alle Zeichen in der aktuellen Instanz aus Zeichen im trimChars Array bestehen, gibt die Methode Emptyzurück.If the current string equals Empty or all the characters in the current instance consist of characters in the trimChars array, the method returns Empty.

Wenn trimChars null oder ein leeres Array ist, entfernt diese Methode alle führenden oder nachfolgenden Zeichen, die dazu führen, dass die Methode true zurückgibt, wenn Sie an die Char.IsWhiteSpace-Methode übermittelt werden.If trimChars is null or an empty array, this method removes any leading or trailing characters that result in the method returning true when they are passed to the Char.IsWhiteSpace method.

Hinweise für Aufrufer

In der-.NET Framework 3.5 SP1.NET Framework 3.5 SP1 und früheren Versionen wird eine interne Liste von leer Raum Zeichen verwaltet, die von dieser Methode nur dann, wenn trimChars null ist, oder ein leeres Array.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. Beginnend mit der .NET Framework 4.NET Framework 4, wenn trimChars null oder ein leeres Array ist, schneidet die-Methode alle Unicode-Leerzeichen (d. h. Zeichen, die einen true Rückgabewert ergeben, wenn Sie an die IsWhiteSpace(Char)-Methode übermittelt werden).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). Aufgrund dieser Änderung werden durch die Trim()-Methode in der .NET Framework 3.5 SP1.NET Framework 3.5 SP1 und früheren Versionen zwei Zeichen entfernt, d. & # 160; 200 & # 160; 200 & # 160; 200 & # 160; null & gt; NULL-Breite, nicht Umbruch Bereich (u + FEFF), dass die Trim()-Methode in der .NET Framework 4.NET Framework 4und höheren VersionenBecause 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 4and later versions does not remove. Außerdem werden durch die Trim()-Methode in der .NET Framework 3.5 SP1.NET Framework 3.5 SP1 und früheren Versionen nicht drei Unicode-leer Raum Zeichen entfernt: Mongolisch vowel Separator (u + 180E), Narrow No-Break Space (u + 202F) und mittlerer mathematischer Raum (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).

Siehe auch

Trim(Char)

Entfernt alle führenden und nachgestellten Instanzen eines Zeichens aus der aktuellen Zeichenfolge.Removes all leading and trailing instances of a character from the current string.

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

Gibt zurück

Die resultierende Zeichenfolge nach dem Entfernen aller Instanzen des Zeichen trimChar am Anfang und Ende der aktuellen Zeichenfolge.The string that remains after all instances of the trimChar character are removed from the start and end of the current string. Wenn keine Zeichen in der aktuellen Instanz gekürzt werden können, gibt die Methode die aktuelle Instanz unverändert zurück.If no characters can be trimmed from the current instance, the method returns the current instance unchanged.

Hinweise

Die Trim(System.Char)-Methode entfernt alle führenden und nachfolgenden Instanzen des trimChar Zeichens aus der aktuellen Zeichenfolge.The Trim(System.Char) method removes from the current string all leading and trailing instances of the trimChar character. Jeder führende und nachfolgende Trim-Vorgang wird beendet, wenn ein anderes Zeichen als trimChar auftritt.Each leading and trailing trim operation stops when a character different from trimChar is encountered. Wenn trimChar beispielsweise - ist und die aktuelle Zeichenfolge "---abc---xyz----" ist, gibt die Trim(System.Char)-Methode "abc---xyz" zurück.For example, if trimChar is - and the current string is "---abc---xyz----", the Trim(System.Char) method returns "abc---xyz". Verwenden Sie reguläre .net-Ausdrücke, um Zeichen zwischen Wörtern in einer Zeichenfolge zu entfernen.To remove characters between words in a string, use .NET Regular Expressions.

Hinweis

Wenn die Trim(System.Char)-Methode alle Zeichen aus der aktuellen Instanz entfernt, ändert diese Methode nicht den Wert der aktuellen Instanz.If the Trim(System.Char) method removes any characters from the current instance, this method does not modify the value of the current instance. Stattdessen wird eine neue Zeichenfolge zurückgegeben, in der alle führenden und nachfolgenden trimChar Zeichen, die in der aktuellen Instanz gefunden werden, entfernt werden.Instead, it returns a new string in which all leading and trailing trimChar characters found in the current instance are removed.

Wenn die aktuelle Zeichenfolge Empty ist oder alle Zeichen in der aktuellen Instanz aus trimChar Zeichen bestehen, gibt die Methode Emptyzurück.If the current string equals Empty or all the characters in the current instance consist of trimChar characters, the method returns Empty.

Trim()

Entfernt alle führenden und nachgestellten Leerraumzeichen aus der aktuellen Zeichenfolge.Removes all leading and trailing white-space characters from the current string.

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.The string that remains after all white-space characters are removed from the start and end of the current string. Wenn keine Zeichen in der aktuellen Instanz gekürzt werden können, gibt die Methode die aktuelle Instanz unverändert zurück.If no characters can be trimmed from the current instance, the method returns the current instance unchanged.

Beispiele

Im folgenden Beispiel wird die String.Trim()-Methode verwendet, um zusätzliche Leerräume aus Zeichen folgen zu entfernen, die vom Benutzer eingegeben wurden, bevor Sie verkettet werden.The following example uses the String.Trim() method to remove any extra white space from strings entered by the user before concatenating them.

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.
    }
}
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.The Trim method removes from the current string all leading and trailing white-space characters. Jeder führende und nachfolgende Trim-Vorgang wird beendet, wenn ein nicht-Leerzeichen auftritt.Each leading and trailing trim operation stops when a non-white-space character is encountered. Wenn die aktuelle Zeichenfolge z. b. "abc xyz" ist, gibt die Trim-Methode "abc xyz" zurück.For example, if the current string is " abc xyz ", the Trim method returns "abc xyz". Verwenden Sie reguläre .net-Ausdrücke, um Leerzeichen zwischen Wörtern in einer Zeichenfolge zu entfernen.To remove white-space characters between words in a string, use .NET Regular Expressions.

Hinweis

Wenn die Trim-Methode alle Zeichen aus der aktuellen Instanz entfernt, ändert diese Methode nicht den Wert der aktuellen Instanz.If the Trim method removes any characters from the current instance, this method does not modify the value of the current instance. Stattdessen wird eine neue Zeichenfolge zurückgegeben, in der alle führenden und nachfolgenden Leerzeichen, die in der aktuellen Instanz gefunden werden, entfernt werden.Instead, it returns a new string in which all leading and trailing white space characters found in the current instance are removed.

Wenn die aktuelle Zeichenfolge Empty ist oder alle Zeichen in der aktuellen Instanz aus Leerzeichen bestehen, gibt die Methode Emptyzurück.If the current string equals Empty or all the characters in the current instance consist of white-space characters, the method returns Empty.

Leerzeichen werden durch den Unicode-Standard definiert.White-space characters are defined by the Unicode standard. Die Trim-Methode entfernt alle führenden und nachfolgenden Zeichen, die einen Rückgabewert von true ergeben, wenn Sie an die Char.IsWhiteSpace-Methode übermittelt werden.The Trim method removes any leading and trailing characters that produce a return value of true when they are passed to the Char.IsWhiteSpace method.

Hinweise für Aufrufer

In der-.NET Framework 3.5 SP1.NET Framework 3.5 SP1 und früheren Versionen wird eine interne Liste von leer Raum Zeichen beibehalten, die von dieser Methode fest sind.The .NET Framework 3.5 SP1.NET Framework 3.5 SP1 and earlier versions maintain an internal list of white-space characters that this method trims. Beginnend mit dem .NET Framework 4.NET Framework 4werden alle Unicode-Leerzeichen (d. h. Zeichen, die einen true Rückgabewert ergeben, wenn Sie an die IsWhiteSpace(Char)-Methode übermittelt werden).Starting with the .NET Framework 4.NET Framework 4, 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). Aufgrund dieser Änderung werden durch die Trim()-Methode in der .NET Framework 3.5 SP1.NET Framework 3.5 SP1 und früheren Versionen zwei Zeichen entfernt, d. & # 160; 200 & # 160; 200 & # 160; 200 & # 160; null & gt; NULL-Breite, nicht Umbruch Bereich (u + FEFF), dass die Trim()-Methode in der .NET Framework 4.NET Framework 4und höheren VersionenBecause 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 4and later versions does not remove. Außerdem werden durch die Trim()-Methode in der .NET Framework 3.5 SP1.NET Framework 3.5 SP1 und früheren Versionen nicht drei Unicode-leer Raum Zeichen entfernt: Mongolisch vowel Separator (u + 180E), Narrow No-Break Space (u + 202F) und mittlerer mathematischer Raum (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).

Siehe auch

Gilt für: