String.Trim Methode

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

Gibt zurück

String

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 trimCharsnull 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-Parameter enthalten sind trimChars .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 nicht in ist, gefunden trimChars 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, Trim(System.Char[]) 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(System.Char[]) method returns "abc456xyz".

Wenn die aktuelle Zeichenfolge ist Empty oder alle Zeichen in der aktuellen Instanz aus Zeichen im Array bestehen trimChars , 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 null oder ein leeres Array ist, entfernt diese Methode alle führenden oder nachfolgenden Zeichen, die dazu führen, dass die Methode zurück true gibt, wenn Sie an die-Methode übermittelt werden Char.IsWhiteSpace .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

Der .NET Framework 3,5 SP1 und frühere Versionen verwaltet eine interne Liste von leer Raum Zeichen, die von dieser Methode als trimChars null oder als leeres Array angegeben werden.The .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 dem .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-Methode übermittelt werden IsWhiteSpace(Char) ) ab.Starting with the .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 Trim() entfernt die-Methode in den .NET Framework 3,5 SP1 und früheren Versionen zwei Zeichen, den Leerraum (u + 200B) und den nicht Umbruch Bereich mit NULL Breite (u + FEFF), dass die Trim() -Methode in der .NET Framework 4und höheren Versionen nicht entfernt wird.Because of this change, the Trim() method in the .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 4and later versions does not remove. Außerdem werden mit der Trim() -Methode in der .NET Framework 3,5 SP1 und früheren Versionen nicht drei Unicode-Leerzeichen 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 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

• Char
• TrimEnd(Char[])
• TrimStart(Char[])
• IsWhiteSpace(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

Gibt zurück

String

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 Zeichens aus der aktuellen Zeichenfolge trimChar .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 gefunden trimChar wird.Each leading and trailing trim operation stops when a character different from trimChar is encountered. Wenn z. b. trimChar ist - und die aktuelle Zeichenfolge "---abc---xyz----" ist, Trim(System.Char) gibt die 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.

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

public:
 System::String ^ Trim();

public string Trim ();

member this.Trim : unit -> string

Public Function Trim () As String

Gibt zurück

String

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.

Wenn die aktuelle Zeichenfolge Empty oder alle Zeichen in der aktuellen Instanz aus Leerzeichen bestehen, gibt die Methode zurück 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 nachfolgenden Zeichen, die einen Rückgabewert von ergeben, true Wenn Sie an die-Methode übermittelt werden Char.IsWhiteSpace .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

Der .NET Framework 3,5 SP1 und frühere Versionen behalten eine interne Liste von leer Raum Zeichen bei, die diese Methode einschneidet.The .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, schneidet die-Methode alle Unicode-Leerzeichen (d. h. Zeichen, die einen true Rückgabewert ergeben, wenn Sie an die-Methode übermittelt werden IsWhiteSpace(Char) ).Starting with the .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 Trim() entfernt die-Methode in den .NET Framework 3,5 SP1 und früheren Versionen zwei Zeichen, den Leerraum (u + 200B) und den nicht Umbruch Bereich mit NULL Breite (u + FEFF), dass die Trim() -Methode in der .NET Framework 4und höheren Versionen nicht entfernt wird.Because of this change, the Trim() method in the .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 4and later versions does not remove. Außerdem werden mit der Trim() -Methode in der .NET Framework 3,5 SP1 und früheren Versionen nicht drei Unicode-Leerzeichen 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 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

• TrimEnd(Char[])
• TrimStart(Char[])
• IsWhiteSpace(Char)