String.TrimEnd String.TrimEnd String.TrimEnd String.TrimEnd Method

Definição

Sobrecargas

TrimEnd() TrimEnd() TrimEnd() TrimEnd()
TrimEnd(Char[]) TrimEnd(Char[]) TrimEnd(Char[]) TrimEnd(Char[])

Remove todas as ocorrências à direita de um conjunto de caracteres especificados em uma matriz do atual objeto String.Removes all trailing occurrences of a set of characters specified in an array from the current String object.

TrimEnd(Char) TrimEnd(Char) TrimEnd(Char) TrimEnd(Char)

TrimEnd() TrimEnd() TrimEnd() TrimEnd()

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

Retornos

TrimEnd(Char[]) TrimEnd(Char[]) TrimEnd(Char[]) TrimEnd(Char[])

Remove todas as ocorrências à direita de um conjunto de caracteres especificados em uma matriz do atual objeto String.Removes all trailing occurrences of a set of characters specified in an array from the current String object.

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

Parâmetros

trimChars
Char[]

Uma matriz de caracteres Unicode a ser removida, ou null.An array of Unicode characters to remove, or null.

Retornos

A cadeia de caracteres que permanece depois que todas as ocorrências dos caracteres no parâmetro trimChars forem removidas do final da cadeia de caracteres atual.The string that remains after all occurrences of the characters in the trimChars parameter are removed from the end of the current string. Se trimChars for null ou uma matriz vazia, os caracteres de espaço em branco Unicode serão removidos.If trimChars is null or an empty array, Unicode white-space characters are removed instead. Se não for possível cortar caracteres da instância atual, o método retornará a instância atual inalterada.If no characters can be trimmed from the current instance, the method returns the current instance unchanged.

Exemplos

O exemplo a seguir demonstra como você pode usar o TrimEnd(Char[]) método Cortar espaços em branco ou marcas de pontuação do final de uma cadeia de caracteres.The following example demonstrates how you can use the TrimEnd(Char[]) method to trim white space or punctuation marks from the end of a string.

using System;

public class TrimEnd
{
   public static void Main()
   {
      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
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

Comentários

O TrimEnd método Remove da cadeia de caracteres atual, todos os caracteres à direita que estão no trimChars parâmetro.The TrimEnd method removes from the current string all trailing characters that are in the trimChars parameter. A operação de corte é interrompido quando o primeiro caractere que não esteja em trimChars é encontrado no final da cadeia de caracteres.The trim operation stops when the first character that is not in trimChars is encountered at the end of the string. Por exemplo, se a cadeia de caracteres atual é "123abc456xyz789" e trimChars contém os dígitos de "1" a "9", o TrimEnd método retorna "123abc456xyz".For example, if the current string is "123abc456xyz789" and trimChars contains the digits from "1" through "9", the TrimEnd method returns "123abc456xyz".

Observação

Se o TrimEnd método Remove todos os caracteres da instância atual, esse método não modifica o valor da instância atual.If the TrimEnd method removes any characters from the current instance, this method does not modify the value of the current instance. Em vez disso, ele retorna uma nova cadeia de caracteres na qual caracteres tudo à direita encontrados no trimChars são removidos da cadeia de caracteres atual.Instead, it returns a new string in which all trailing characters found in trimChars are removed from the current string.

Notas aos Chamadores

O .NET Framework 3,5 SP1.NET Framework 3.5 SP1 e versões anteriores mantém uma lista interna de caracteres de espaço em branco que esse método corta se trimChars é null ou uma matriz vazia.The .NET Framework 3,5 SP1.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. Começando com o .NET Framework 4.NET Framework 4, se trimChars é null ou uma matriz vazia, o método Remove todos os caracteres de espaço em branco Unicode (isto é, os caracteres que produzem um true valor de retorno quando eles são passados para o IsWhiteSpace(Char) método).Starting with the .NET Framework 4.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). Por causa dessa alteração, o Trim() método na .NET Framework 3,5 SP1.NET Framework 3.5 SP1 e versões anteriores remove dois caracteres, o espaço de largura ZERO (U + 200B) e espaço sem quebra de largura ZERO (U + FEFF), que o Trim() método no .NET Framework 4.NET Framework 4 e versões posteriores não não remover.Because of this change, the Trim() method in the .NET Framework 3,5 SP1.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 4.NET Framework 4 and later versions does not remove. Além disso, o Trim() método no .NET Framework 3,5 SP1.NET Framework 3.5 SP1 e versões anteriores não apare três caracteres de espaço em branco Unicode: SEPARADOR de VOGAL MONGOL (U + 180E), espaço limitado de não-SEPARAÇÃO (U + 202F) e espaço de MATEMÁTICA de médio (U + 205F).In addition, the Trim() method in the .NET Framework 3,5 SP1.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).

Veja também

TrimEnd(Char) TrimEnd(Char) TrimEnd(Char) 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

Parâmetros

trimChar
Char Char Char Char

Retornos

Aplica-se a