String.TrimEnd Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Sobrecargas

TrimEnd()	Remove todos os caracteres de espaço em branco da cadeia de caracteres atual.
TrimEnd(Char)	Remove todas as ocorrências à direita da cadeia de caracteres atual.
TrimEnd(Char[])	Remove todas as ocorrências à direita de um conjunto de caracteres especificados em uma matriz da cadeia de caracteres atual.

TrimEnd()

Origem:

String.Manipulation.cs

Remove todos os caracteres de espaço em branco da cadeia de caracteres atual.

public:
 System::String ^ TrimEnd();

public string TrimEnd ();

member this.TrimEnd : unit -> string

Public Function TrimEnd () As String

Retornos

String

A cadeia de caracteres que permanece depois que todos os caracteres de espaço em branco forem removidos do final da cadeia de caracteres atual. Se não for possível cortar caracteres da instância atual, o método retornará a instância atual inalterada.

Comentários

O TrimEnd método remove da cadeia de caracteres atual todos os caracteres de espaço em branco à direita. A operação de corte é interrompida quando o primeiro caractere sem espaço em branco é encontrado no final da cadeia de caracteres. Por exemplo, se a cadeia de caracteres atual for " abc xyz ", o TrimEnd método retornará " abc xyz".

Observação

Se o TrimEnd método remover qualquer caractere da instância atual, esse método não modificará o valor da instância atual. Em vez disso, ele retorna uma nova cadeia de caracteres na qual todos os caracteres de espaço em branco à direita são removidos da cadeia de caracteres atual.

TrimEnd(Char)

Origem:

String.Manipulation.cs

Remove todas as ocorrências à direita da cadeia de caracteres atual.

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

Um caractere Unicode a ser removido.

Retornos

String

A cadeia de caracteres que permanece depois que todas as ocorrências do caractere trimChar forem removidas do final da cadeia de caracteres atual. Se não for possível cortar caracteres da instância atual, o método retornará a instância atual inalterada.

Comentários

O TrimEnd(System.Char) método remove da cadeia de caracteres atual todos os caracteres à trimChar direita. A operação de corte é interrompida quando o primeiro caractere que não trimChar é encontrado no final da cadeia de caracteres. Por exemplo, se trimChar for - e a cadeia de caracteres atual for "---abc---xyz----", o TrimEnd(System.Char) método retornará "---abc---xyz".

Observação

Se o TrimEnd(System.Char) método remover qualquer caractere da instância atual, esse método não modificará o valor da instância atual. Em vez disso, ele retorna uma nova cadeia de caracteres na qual todos os caracteres à trimChar direita são removidos da cadeia de caracteres atual.

TrimEnd(Char[])

Origem:

String.Manipulation.cs

Remove todas as ocorrências à direita de um conjunto de caracteres especificados em uma matriz da cadeia de caracteres atual.

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.

Retornos

String

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. Se trimChars for null ou uma matriz vazia, os caracteres de espaço em branco Unicode serão removidos. Se não for possível cortar caracteres da instância atual, o método retornará a instância atual inalterada.

Exemplos

O exemplo a seguir demonstra como você pode usar o TrimEnd(System.Char[]) método para cortar espaços em branco ou marcas de pontuação do final de uma cadeia de caracteres.

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

Comentários

O TrimEnd(System.Char[]) método remove da cadeia de caracteres atual todos os caracteres à direita que estão no trimChars parâmetro . A operação de corte é interrompida quando o primeiro caractere que não está em trimChars é encontrado no final da cadeia de caracteres. Por exemplo, se a cadeia de caracteres atual for "123abc456xyz789" e trimChars contiver os dígitos de "1" a "9", o TrimEnd(System.Char[]) método retornará "123abc456xyz".

Observação

Se o TrimEnd(System.Char[]) método remover qualquer caractere da instância atual, esse método não modificará o valor da instância atual. Em vez disso, ele retorna uma nova cadeia de caracteres na qual todos os caracteres à direita encontrados em trimChars são removidos da cadeia de caracteres atual.

Notas aos Chamadores

O .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 for null ou uma matriz vazia. Começando com o .NET Framework 4, se trimChars for null ou uma matriz vazia, o método cortará todos os caracteres de espaço em branco Unicode (ou seja, caracteres que produzem um true valor retornado quando são passados para o IsWhiteSpace(Char) método). Devido a essa alteração, o Trim() método no .NET Framework 3.5 SP1 e versões anteriores remove dois caracteres, ZERO WIDTH SPACE (U+200B) e ZERO WIDTH NO-BREAK SPACE (U+FEFF), que o Trim() método no .NET Framework 4 e versões posteriores não remove. Além disso, o Trim() método no .NET Framework 3.5 SP1 e versões anteriores não corta três caracteres de espaço em branco Unicode: U+180E (U+180E), ESPAÇO RESTRITO SEM INTERRUPÇÃO (U+202F) e ESPAÇO MATEMÁTICO MÉDIO (U+205F).

Confira também

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