String.TrimEnd Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Przeciążenia

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

TrimEnd()

Źródło:

String.Manipulation.cs

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

public:
 System::String ^ TrimEnd();

public string TrimEnd ();

member this.TrimEnd : unit -> string

Public Function TrimEnd () As String

Zwraca

String

Ciąg, który pozostaje po usunięciu wszystkich znaków odstępu na końcu 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 TrimEnd usuwa z bieżącego ciągu wszystkie końcowe znaki odstępu. Operacja przycinania zatrzymuje się, gdy na końcu ciągu napotkany jest pierwszy znak bez odstępu. Jeśli na przykład bieżący ciąg to " abc xyz ", metoda TrimEnd zwraca wartość " abc xyz".

Nuta

Jeśli metoda TrimEnd usuwa 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 wszystkie końcowe znaki odstępu są usuwane z bieżącego ciągu.

TrimEnd(Char)

Źródło:

String.Manipulation.cs

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

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

public string TrimEnd (char trimChar);

member this.TrimEnd : char -> string

Public Function TrimEnd (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ń znaku trimChar z 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 TrimEnd(System.Char) usuwa z bieżącego ciągu wszystkie końcowe znaki trimChar. Operacja przycinania zostaje zatrzymana, gdy pierwszy znak, który nie jest trimChar, zostanie napotkany na końcu ciągu. Jeśli na przykład trimChar jest -, a bieżący ciąg to "---abc---xyz----", metoda TrimEnd(System.Char) zwraca wartość "---abc---xyz".

Nuta

Jeśli metoda TrimEnd(System.Char) usuwa 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 wszystkie końcowe znaki trimChar są usuwane z bieżącego ciągu.

TrimEnd(Char[])

Źródło:

String.Manipulation.cs

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

public:
 System::String ^ TrimEnd(... cli::array <char> ^ trimChars);

public string TrimEnd (params char[]? trimChars);

member this.TrimEnd : char[] -> string

Public Function TrimEnd (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, zostanie usunięty z końca bieżącego ciągu. Jeśli trimChars jest null lub pusta tablica, zamiast tego zostaną usunięte znaki odstępu Unicode. 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 pokazano, jak można użyć metody TrimEnd(System.Char[]) do przycinania białych znaków lub znaków interpunkcyjnych z końca ciągu.

string sentence = "The dog had a bone, a ball, and other toys.";
char[] charsToTrim = {',', '.', ' '};
string[] words = sentence.Split();
foreach (string word in words)
   Console.WriteLine(word.TrimEnd(charsToTrim));

// The example displays the following output:
//       The
//       dog
//       had
//       a
//       bone
//       a
//       ball
//       and
//       other
//       toys

let sentence = "The dog had a bone, a ball, and other toys."
let charsToTrim = [| ','; '.'; ' ' |]
let words = sentence.Split()
for word in words do
    printfn $"{word.TrimEnd charsToTrim}"

// The example displays the following output:
//       The
//       dog
//       had
//       a
//       bone
//       a
//       ball
//       and
//       other
//       toys

Module TrimEnd
   Public Sub Main()
      Dim sentence As String = "The dog had a bone, a ball, and other toys."
      Dim charsToTrim() As Char = {","c, "."c, " "c}
      Dim words() As String = sentence.Split()
      For Each word As String In words
         Console.WriteLine(word.TrimEnd(charsToTrim))
      Next
   End Sub
End Module
' The example displays the following output:
'       The
'       dog
'       had
'       a
'       bone
'       a
'       ball
'       and
'       other
'       toys

Uwagi

Metoda TrimEnd(System.Char[]) usuwa z bieżącego ciągu wszystkie końcowe znaki, które znajdują się w parametrze trimChars. Operacja przycinania zatrzymuje się, gdy pierwszy znak, który nie znajduje się w trimChars, zostanie napotkany na końcu ciągu. Jeśli na przykład bieżący ciąg to "123abc456xyz789" i trimChars zawiera cyfry z "1" do "9", metoda TrimEnd(System.Char[]) zwraca wartość "123abc456xyz".

Nuta

Jeśli metoda TrimEnd(System.Char[]) usuwa 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 wszystkie końcowe znaki znalezione w trimChars są usuwane z bieżącego ciągu.

Uwagi 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 pusta tablica. Począwszy od programu .NET Framework 4, jeśli trimChars jest null lub pusta tablica, 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 tę zmianę metoda Trim() w programie .NET Framework 3.5 z dodatkiem SP1 i wcześniejszych wersjach usuwa dwa znaki, zero WIDTH SPACE (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 metoda Trim() w programie .NET Framework 3.5 SP1 i wcześniejszych wersjach nie przycina trzech znaków odstępów Unicode: SEPARATOR VOWEL MONGOLN (U+180E), WĄSKI NO-BREAK SPACJI (U+202F) i ŚREDNIEJ PRZESTRZENI MATEMATYCZNEJ (U+205F).

Zobacz też

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