String.Trim String.Trim String.Trim String.Trim Method

Definition

Gibt eine neue Zeichenfolge zurück, in der alle führenden und nachgestellten Vorkommen eines Satzes von angegebenen Zeichen aus dem aktuellen String-Objekt entfernt wurden.Returns a new string in which all leading and trailing occurrences of a set of specified characters from the current String object are removed.

Überlädt

Trim(Char[]) Trim(Char[]) Trim(Char[]) Trim(Char[])

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

Trim(Char) Trim(Char) Trim(Char) Trim(Char)
Trim() Trim() Trim() Trim()

Entfernt alle führenden und nachgestellten Leerraumzeichen aus dem aktuellen String-Objekt.Removes all leading and trailing white-space characters from the current String object.

Trim(Char[]) Trim(Char[]) Trim(Char[]) Trim(Char[])

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

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 String.Trim(Char[]) -Methode verwendet, um Leerzeichen, Sternchen (*) und Apostroph (') aus einer Zeichenfolge zu entfernen.The following example uses the String.Trim(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 -Methode entfernt alle führenden und nachfolgenden Zeichen aus der aktuellen Zeichenfolge, trimChars die im-Parameter enthalten sind.The Trim 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 trimChars , das nicht in ist, 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" trimChars ist und die Ziffern von "1" bis "9" enthält Trim , gibt die Methode "abc456xyz" zurück.For example, if the current string is "123abc456xyz789" and trimChars contains the digits from "1" through "9", the Trim method returns "abc456xyz".

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 in trimChars der aktuellen Instanz gefundenen führenden und nachfolgenden Zeichen 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 trimChars im Array bestehen, gibt die Methode zurück Empty.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 oder null ein leeres Array ist, entfernt diese Methode alle führenden oder nachfolgenden Zeichen, die dazu führen, true dass die Methode zurückgibt, Char.IsWhiteSpace Wenn Sie an die-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 .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 trimChars dann null untersucht werden, wenn 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. .NET Framework 4.NET Framework 4Beginnend mit IsWhiteSpace(Char) , wenn trimChars oder ein null leeres Array ist, schneidet die-Methode alle Unicode-Leerzeichen ab (d. h. Zeichen, die einen true Rückgabewert ergeben, wenn Sie an die-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 entfernt Trim() die-Methode in der-und der .NET Framework 3.5 SP1.NET Framework 3.5 SP1 früheren-Version zwei Zeichen, den Leerraum (u + 200B) und den NULL-Wert ohne Umbruch Zeichen (u + FEFF) Trim() , .NET Framework 4.NET Framework 4dass die-Methode in und höheren Versionen nicht entfernen.Because 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 mit der Trim() .NET Framework 3.5 SP1.NET Framework 3.5 SP1 -Methode in und früheren Versionen nicht drei Unicode-leer Raum Zeichen beschnitten: Mongolischer vowel-Trennzeichen (u + 180E), schmaler, nicht Umbruch Bereich (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) Trim(Char) Trim(Char) Trim(Char)

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 Char Char Char

Gibt zurück

Trim() Trim() Trim() Trim()

Entfernt alle führenden und nachgestellten Leerraumzeichen aus dem aktuellen String-Objekt.Removes all leading and trailing white-space characters from the current String object.

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 alle zusätzlichen Leerzeichen 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 Trim , gibt die 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 oder alle Zeichen in der aktuellen Instanz aus Leerzeichen bestehen, gibt die Methode zurück. EmptyIf 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ückgabe true Wert von ergeben, wenn Sie Char.IsWhiteSpace an die-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 .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 .NET Framework 4.NET Framework 4stellt 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, 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 entfernt Trim() die-Methode in der-und der .NET Framework 3.5 SP1.NET Framework 3.5 SP1 früheren-Version zwei Zeichen, den Leerraum (u + 200B) und den NULL-Wert ohne Umbruch Zeichen (u + FEFF) Trim() , .NET Framework 4.NET Framework 4dass die-Methode in und höheren Versionen nicht entfernen.Because 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 mit der Trim() .NET Framework 3.5 SP1.NET Framework 3.5 SP1 -Methode in und früheren Versionen nicht drei Unicode-leer Raum Zeichen beschnitten: Mongolischer vowel-Trennzeichen (u + 180E), schmaler, nicht Umbruch Bereich (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: