String.Trim Metoda

Definicja

Przestrzeń nazw:

System

Zestawy:

netstandard.dll, System.Runtime.dll

Zwraca nowy ciąg, w którym usuwane są wszystkie wystąpienia wiodące i końcowe zestawu określonych znaków z bieżącego ciągu.

Przeciążenia

Nazwa	Opis
Trim(Char[])	Usuwa wszystkie wystąpienia wiodące i końcowe zestawu znaków określonych w tablicy z bieżącego ciągu.
Trim(Char)	Usuwa wszystkie wystąpienia wiodące i końcowe znaku z bieżącego ciągu.
Trim()	Usuwa wszystkie wiodące i końcowe znaki odstępu z bieżącego ciągu.

Trim(Char[])

Źródło:

String.Manipulation.cs

Usuwa wszystkie wystąpienia wiodące i końcowe zestawu znaków określonych w tablicy z bieżącego ciągu.

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

Parametry

trimChars

Char[]

Tablica znaków Unicode do usunięcia lub null.

Zwraca

String

Ciąg, który pozostaje po wszystkich wystąpieniach znaków w parametrze trimChars , zostaną usunięte z początku i końca bieżącego ciągu. Jeśli trimChars jest null lub pusta tablica, zamiast tego zostaną usunięte znaki odstępu. Jeśli nie można przyciąć znaków z bieżącego wystąpienia, metoda zwraca bieżące wystąpienie bez zmian.

Przykłady

W poniższym przykładzie użyto Trim(System.Char[]) metody , aby usunąć spację, gwiazdkę (*)i znaki apostrofu (') z ciągu.

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'

Uwagi

Metoda Trim(System.Char[]) usuwa z bieżącego ciągu wszystkie znaki wiodące i końcowe, które znajdują się w parametrze trimChars . Każda operacja przycinania wiodącego i końcowego zatrzymuje się, gdy napotkano znak, który nie trimChars występuje. Jeśli na przykład bieżący ciąg to "123abc456xyz789" i trimChars zawiera cyfry z "1" do "9", Trim(System.Char[]) metoda zwraca wartość "abc456xyz".

Note

Trim(System.Char[]) Jeśli metoda usunie wszelkie znaki z bieżącego wystąpienia, ta metoda nie modyfikuje wartości bieżącego wystąpienia. Zamiast tego zwraca nowy ciąg, w którym zostaną usunięte wszystkie znaki wiodące i końcowe trimChars znalezione w bieżącym wystąpieniu.

Jeśli bieżący ciąg jest Empty równy lub wszystkie znaki w bieżącym wystąpieniu składają się z znaków w trimChars tablicy, metoda zwraca wartość Empty.

Jeśli trimChars jest null lub pusta tablica, ta metoda usuwa wszelkie znaki wiodące lub końcowe, które powodują zwrócenie true metody po przekazaniu ich do Char.IsWhiteSpace metody.

Notatki dotyczące wywoływania

Program .NET Framework 3.5 z dodatkiem SP1 i starsze wersje obsługuje wewnętrzną listę znaków odstępów, które ta metoda przycina, jeśli trimChars jest null lub jest pusta tablica. Począwszy od programu .NET Framework 4, jeśli trimChars jest to null lub pusta tablica, metoda przycina wszystkie znaki odstępu Unicode (czyli znaki, które generują wartość zwracaną true po przekazaniu IsWhiteSpace(Char) ich do metody). Ze względu na tę zmianę metoda Trim() w .NET Framework 3.5 z dodatkiem SP1 i wcześniejszych wersjach usuwa dwa znaki, ZERO WIDTH SPACJA (U+200B) i ZERO WIDTH NO-BREAK SPACE (U+FEFF), że metoda Trim() w programie .NET Framework 4 i nowszych wersjach nie zostanie usunięta. Ponadto Trim() metoda w programie .NET Framework 3.5 SP1 i wcześniejszych wersjach nie przycina trzech znaków odstępów Unicode: SEPARATOR VOWEL MONGOLIAN (U+180E), NARROW NO-BREAK SPACE (U+202F) i ŚREDNIEJ PRZESTRZENI MATEMATYCZNEJ (U+205F).

Zobacz też

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

Trim(Char)

Źródło:

String.Manipulation.cs

Usuwa wszystkie wystąpienia wiodące i końcowe znaku z bieżącego ciągu.

public:
 System::String ^ Trim(char trimChar);

public string Trim(char trimChar);

member this.Trim : char -> string

Public Function Trim (trimChar As Char) As String

Parametry

trimChar

Char

Znak Unicode do usunięcia.

Zwraca

String

Ciąg, który pozostaje po usunięciu wszystkich wystąpień trimChar znaku od początku i końca bieżącego ciągu. Jeśli nie można przyciąć znaków z bieżącego wystąpienia, metoda zwraca bieżące wystąpienie bez zmian.

Uwagi

Metoda Trim(System.Char) usuwa z bieżącego ciągu wszystkie wiodące i końcowe wystąpienia trimChar znaku. Każda operacja przycinania wiodącego i końcowego zatrzymuje się, gdy napotkany jest znak inny niż trimChar . Jeśli na przykład trimChar wartość to , - a bieżący ciąg to "---abc---xyz----", Trim(System.Char) metoda zwraca wartość "abc---xyz". Aby usunąć znaki między wyrazami w ciągu, użyj .NET wyrażeń regularnych.

Note

Trim(System.Char) Jeśli metoda usunie wszelkie znaki z bieżącego wystąpienia, ta metoda nie modyfikuje wartości bieżącego wystąpienia. Zamiast tego zwraca nowy ciąg, w którym zostaną usunięte wszystkie znaki wiodące i końcowe trimChar znalezione w bieżącym wystąpieniu.

Jeśli bieżący ciąg jest Empty równy lub wszystkie znaki w bieżącym wystąpieniu składają się z trimChar znaków, metoda zwraca wartość Empty.

Trim()

Źródło:

String.Manipulation.cs

Usuwa wszystkie wiodące i końcowe znaki odstępu z bieżącego ciągu.

public:
 System::String ^ Trim();

public string Trim();

member this.Trim : unit -> string

Public Function Trim () As String

Zwraca

String

Ciąg, który pozostaje po usunięciu wszystkich znaków odstępu od początku i końca bieżącego ciągu. Jeśli nie można przyciąć znaków z bieżącego wystąpienia, metoda zwraca bieżące wystąpienie bez zmian.

Przykłady

W poniższym przykładzie użyto String.Trim() metody , aby usunąć wszelkie dodatkowe białe znaki z ciągów wprowadzonych przez użytkownika przed ich połączeniem.

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.

Uwagi

Metoda Trim usuwa z bieżącego ciągu wszystkie wiodące i końcowe znaki odstępu. Każda operacja przycinania wiodącego i końcowego zatrzymuje się po napotkaniu znaku innego niż odstęp. Jeśli na przykład bieżący ciąg to " abc xyz ", Trim metoda zwraca wartość "abc xyz". Aby usunąć znaki odstępu między wyrazami w ciągu, użyj .NET wyrażeń regularnych.

Note

Trim Jeśli metoda usunie wszelkie znaki z bieżącego wystąpienia, ta metoda nie modyfikuje wartości bieżącego wystąpienia. Zamiast tego zwraca nowy ciąg, w którym usuwane są wszystkie wiodące i końcowe białe znaki znalezione w bieżącym wystąpieniu.

Jeśli bieżący ciąg jest Empty równy lub wszystkie znaki w bieżącym wystąpieniu składają się z znaków odstępu, metoda zwraca wartość Empty.

Znaki odstępu są definiowane przez standard Unicode. Metoda Trim usuwa wszystkie znaki wiodące i końcowe, które generują wartość true zwracaną po przekazaniu Char.IsWhiteSpace ich do metody.

Notatki dotyczące wywoływania

Program .NET Framework 3.5 z dodatkiem SP1 i starsze wersje utrzymują wewnętrzną listę znaków odstępów, które ta metoda przycina. Począwszy od platformy .NET Framework 4, metoda przycina wszystkie znaki spacji Unicode (czyli znaki, które generują true wartość zwracaną po przekazaniu ich do metody IsWhiteSpace(Char)). Ze względu na Trim() tę zmianę metoda w programie .NET Framework 3.5 SP1 i wcześniejszych wersjach usuwa dwa znaki, zero WIDTH SPACE (U+200B) i ZERO WIDTH NO-BREAK SPACE (U+FEFF), że Trim() metoda w programie .NET Framework 4 i nowszych wersjach nie zostanie usunięta. Ponadto Trim() metoda w programie .NET Framework 3.5 SP1 i wcześniejszych wersjach nie przycina trzech znaków odstępów Unicode: SEPARATOR VOWEL MONGOLIAN (U+180E), NARROW NO-BREAK SPACE (U+202F) i ŚREDNIEJ PRZESTRZENI MATEMATYCZNEJ (U+205F).

Zobacz też

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