String.TrimEnd Метод

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Перегрузки

TrimEnd()	Удаляет все конечные пробелы из текущей строки.
TrimEnd(Char)	Удаляет все конечные вхождения символа из текущей строки.
TrimEnd(Char[])	Удаляет все конечные вхождения набора символов, указанных в массиве из текущей строки.

TrimEnd()

Исходный код:

String.Manipulation.cs

Удаляет все конечные пробелы из текущей строки.

public:
 System::String ^ TrimEnd();

public string TrimEnd ();

member this.TrimEnd : unit -> string

Public Function TrimEnd () As String

Возвращаемое значение

String

Строка, которая остается после удаления всех символов пробелов из конца текущей строки. Если символы не могут быть обрезаны из текущего экземпляра, метод возвращает текущий экземпляр без изменений.

Комментарии

Метод TrimEnd удаляет из текущей строки все конечные символы пробела. Операция обрезки останавливается при обнаружении первого символа, отличного от пробела, в конце строки. Например, если текущая строка имеет значение abc xyz", метод TrimEnd возвращает "abc xyz".

Заметка

Если метод TrimEnd удаляет любые символы из текущего экземпляра, этот метод не изменяет значение текущего экземпляра. Вместо этого возвращается новая строка, в которой все конечные пробелы удаляются из текущей строки.

TrimEnd(Char)

Исходный код:

String.Manipulation.cs

Удаляет все конечные вхождения символа из текущей строки.

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

public string TrimEnd (char trimChar);

member this.TrimEnd : char -> string

Public Function TrimEnd (trimChar As Char) As String

Параметры

trimChar

Char

Символ Юникода для удаления.

Возвращаемое значение

String

Строка, которая остается после всех вхождения символов trimChar, удаляется из конца текущей строки. Если символы не могут быть обрезаны из текущего экземпляра, метод возвращает текущий экземпляр без изменений.

Комментарии

Метод TrimEnd(System.Char) удаляет из текущей строки все конечные trimChar символы. Операция обрезки останавливается, когда первый символ, который не trimChar обнаружен в конце строки. Например, если trimChar-, а текущая строка — "---abc---xyz----", метод TrimEnd(System.Char) возвращает значение "---abc---xyz".

Заметка

Если метод TrimEnd(System.Char) удаляет любые символы из текущего экземпляра, этот метод не изменяет значение текущего экземпляра. Вместо этого он возвращает новую строку, в которой все конечные trimChar символы удаляются из текущей строки.

TrimEnd(Char[])

Исходный код:

String.Manipulation.cs

Удаляет все конечные вхождения набора символов, указанных в массиве из текущей строки.

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

Параметры

trimChars

Char[]

Массив символов Юникода для удаления или null.

Возвращаемое значение

String

Строка, которая остается после всех вхождения символов в параметре trimChars, удаляется из конца текущей строки. Если trimCharsnull или пустой массив, вместо этого удаляются символы пробелов в Юникоде. Если символы не могут быть обрезаны из текущего экземпляра, метод возвращает текущий экземпляр без изменений.

Примеры

В следующем примере показано, как использовать метод TrimEnd(System.Char[]) для обрезки пробелов или знаков препинания из конца строки.

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

Комментарии

Метод TrimEnd(System.Char[]) удаляет из текущей строки все конечные символы, находящиеся в параметре trimChars. Операция обрезки останавливается, когда первый символ, который не находится в trimChars, встречается в конце строки. Например, если текущая строка имеет значение "123abc456xyz789" и trimChars содержит цифры от "1" до "9", метод TrimEnd(System.Char[]) возвращает значение "123abc456xyz".

Заметка

Если метод TrimEnd(System.Char[]) удаляет любые символы из текущего экземпляра, этот метод не изменяет значение текущего экземпляра. Вместо этого возвращается новая строка, в которой все конечные символы, найденные в trimChars, удаляются из текущей строки.

Примечания для тех, кто вызывает этот метод

Платформа .NET Framework 3.5 с пакетом обновления 1 (SP1) и более ранние версии поддерживает внутренний список символов пробелов, которые этот метод обрезает, если trimCharsnull или пустой массив. Начиная с .NET Framework 4, если trimCharsnull или пустой массив, метод обрезает все символы пробелов Юникода (то есть символы, которые создают true возвращаемое значение при передаче в метод IsWhiteSpace(Char)). Из-за этого изменения метод Trim() в .NET Framework 3.5 с пакетом обновления 1 (SP1) и более ранних версиях удаляет два символа, НОЛЬ ШИРИНЫ (U+200B) и НУЛЕВОЙ ШИРИНЫ NO-BREAK ПРОБЕЛ (U+FEFF), что метод Trim() в .NET Framework 4 и более поздних версиях не удаляется. Кроме того, метод Trim() в .NET Framework 3.5 с пакетом обновления 1 (SP1) и более ранних версиях не обрезает три символа пробела Юникода: РАЗДЕЛИТЕЛЬ VOWEL (U+180E), СУЗИТЬ NO-BREAK ПРОБЕЛ (U+202F) и СРЕДНИЙ МАТЕМАТИЧЕСКИЙ ПРОБЕЛ (U+205F).

См. также раздел

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