String.TrimEnd Метод

Определение

Перегрузки

TrimEnd()

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

TrimEnd(Char)

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

TrimEnd(Char[])

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

TrimEnd()

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

public:
 System::String ^ TrimEnd();
public string TrimEnd ();
member this.TrimEnd : unit -> string
Public Function TrimEnd () As String

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

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

Комментарии

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

Примечание

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

Применяется к

TrimEnd(Char)

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

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

Удаляемый символ Юникода.

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

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

Комментарии

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

Примечание

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

Применяется к

TrimEnd(Char[])

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

public:
 System::String ^ TrimEnd(... cli::array <char> ^ trimChars);
public string TrimEnd (params 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.

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

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

Примеры

В следующем примере показано, как использовать 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) и более ранних версиях поддерживается внутренний список символов пробелов, которые этот метод обрезает, если trimChars является null или пустым массивом. Начиная с платформа .NET Framework 4, если trimChars является null или пустым массивом, метод обрезает все пробелы в Юникоде (т. е. символы, которые создают возвращаемое true значение при их передаче в IsWhiteSpace(Char) метод). Из-за этого изменения Trim() метод в платформа .NET Framework 3.5 с пакетом обновления 1 (SP1) и более ранних версиях удаляет два символа: ZERO WIDTH SPACE (U+200B) и ZERO WIDTH NO-BREAK SPACE (U+FEFF), которые Trim() метод в платформа .NET Framework 4 и более поздних версиях не удаляет. Кроме того, Trim() метод в платформа .NET Framework 3.5 с пакетом обновления 1 (SP1) и более ранних версиях не обрезает три символа пробела Юникода: МОНГОЛЬСКИЙ ГЛАСНЫЙ РАЗДЕЛИТЕЛЬ (U+180E), NARROW NO-BREAK SPACE (U+202F) и MEDIUM MATHEMATICAL SPACE (U+205F).

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

Применяется к