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 wird die String.Trim(Char[]) Methode, um Speicherplatz, Sternchen (*) und Apostroph (')-Zeichen 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'
using System;

public class Example
{
   public static void Main()
   {
      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 wird aus der aktuellen Zeichenfolge entfernt, alle führende und nachgestellte Zeichen in der trimChars Parameter.The Trim method removes from the current string all leading and trailing characters that are in the trimChars parameter. Jede führende und nachfolgende trim-Vorgang wird beendet, wenn ein Zeichen, das nicht trimChars festgestellt wird.Each leading and trailing trim operation stops when a character that is not in trimChars is encountered. Wenn die aktuelle Zeichenfolge "123abc456xyz789" lautet z. B. und trimChars die Ziffern von "1" bis "9", enthält die Trim Methodenrückgabe "abc456xyz".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 entfernt alle Zeichen aus der aktuellen Instanz, die diese Methode ändert 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 dem alle führenden und nachfolgenden trimChars Zeichen, die in der aktuellen Instanz gefunden werden entfernt.Instead, it returns a new string in which all leading and trailing trimChars characters found in the current instance are removed.

Gleich die aktuelle Zeichenfolge Empty oder alle Zeichen in der aktuellen Instanz von Zeichen in der trimChars array, der Methodenrückgabe 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 ist null oder ein leeres Array, das diese Methode entfernt alle führenden oder nachgestellten Zeichen, die in der Methode zurückgeben zu true sie werden beim übergeben, um die Char.IsWhiteSpace -MethodeIf 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

Die .NET Framework 3.5 SP1.NET Framework 3.5 SP1 und frühere Versionen verwaltet eine interne Liste von Leerzeichen, die diese Methode entfernt, wenn trimChars ist null 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 ist null oder ein leeres Array, der die Methode entfernt alle Leerzeichen-Unicode-Zeichen (d. h. Zeichen, erzeugen einen true Wert zurückgeben, wenn es sich bei der Übergabe an die IsWhiteSpace(Char) Methode).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 der Trim() -Methode in der der .NET Framework 3.5 SP1.NET Framework 3.5 SP1 und frühere Versionen werden zwei Zeichen, NULLBREITE (U + 200 b) und 0 (null) Breite geschütztes Leerzeichen (U + FEFF), entfernt, die die Trim() -Methode in der die .NET Framework 4.NET Framework 4und höhere Versionen ist 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. Darüber hinaus die Trim() -Methode in der die .NET Framework 3.5 SP1.NET Framework 3.5 SP1 und frühere Versionen nicht abtrennt drei Unicode-Zeichen enthalten: MONGOLISCH VOKALTRENNZEICHEN (U + 180E), SCHMALEN geschütztes Leerzeichen (U + 202F) und mittlere MATHEMATISCHE Leerzeichen (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, um zusätzliche Leerzeichen in Zeichenfolgen, die vom Benutzer eingegeben werden vor der Verkettung zu entfernen.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 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 wird aus der aktuellen Zeichenfolge entfernt, alle führende und nachgestellte Leerraumzeichen.The Trim method removes from the current string all leading and trailing white-space characters. Jede führenden und nachfolgenden Vorgang wird beendet, wenn eine nicht-Leerzeichen erkannt wird.Each leading and trailing trim operation stops when a non-white-space character is encountered. Wenn die aktuelle Zeichenfolge "Abc Xyz" wird z. B. die Trim Methodenrückgabe "Xyz" Abc ".For example, if the current string is " abc xyz ", the Trim method returns "abc xyz". Verwenden Sie zum Entfernen von Leerzeichen zwischen Wörtern in einer Zeichenfolge reguläre Ausdrücke von .NET.To remove white-space characters between words in a string, use .NET Regular Expressions.

Hinweis

Wenn die Trim -Methode entfernt alle Zeichen aus der aktuellen Instanz, die diese Methode ändert 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, die in der alle führenden und nachgestellten Leerraumzeichen finden Sie in der aktuellen Instanz entfernt werden zurückgegeben.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 entspricht Empty oder alle Zeichen in der aktuellen Instanz bestehen von Leerzeichen ab, der Methodenrückgabe Empty.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 nachgestellten Zeichen, die der Rückgabewert erzeugen true sie werden beim übergeben, um die Char.IsWhiteSpace Methode.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

Die .NET Framework 3.5 SP1.NET Framework 3.5 SP1 und frühere Versionen behalten eine interne Liste von Leerzeichen, die diese Methode entfernt.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 der .NET Framework 4.NET Framework 4, schneidet die Methode alle Unicode-Leerzeichen (d. h. Zeichen, erzeugen einen true Wert zurückgeben, wenn es sich bei der Übergabe an die IsWhiteSpace(Char) Methode).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 der Trim() -Methode in der der .NET Framework 3.5 SP1.NET Framework 3.5 SP1 und frühere Versionen werden zwei Zeichen, NULLBREITE (U + 200 b) und 0 (null) Breite geschütztes Leerzeichen (U + FEFF), entfernt, die die Trim() -Methode in der die .NET Framework 4.NET Framework 4und höhere Versionen ist 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. Darüber hinaus die Trim() -Methode in der die .NET Framework 3.5 SP1.NET Framework 3.5 SP1 und frühere Versionen nicht abtrennt drei Unicode-Zeichen enthalten: MONGOLISCH VOKALTRENNZEICHEN (U + 180E), SCHMALEN geschütztes Leerzeichen (U + 202F) und mittlere MATHEMATISCHE Leerzeichen (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: