String.TrimEnd Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| Name | Description |
|---|---|
| TrimEnd(Rune) | |
| TrimEnd() |
Remove todos os caracteres de espaço em branco finais da cadeia atual. |
| TrimEnd(Char) |
Remove todas as ocorrências finais de um carácter da cadeia atual. |
| TrimEnd(Char[]) |
Remove todas as ocorrências finais de um conjunto de caracteres especificados num array da cadeia atual. |
TrimEnd(Rune)
- Origem:
- String.Manipulation.cs
public:
System::String ^ TrimEnd(System::Text::Rune trimRune);
public string TrimEnd(System.Text.Rune trimRune);
member this.TrimEnd : System.Text.Rune -> string
Public Function TrimEnd (trimRune As Rune) As String
Parâmetros
- trimRune
- Rune
Devoluções
Aplica-se a
TrimEnd()
- Origem:
- String.Manipulation.cs
- Origem:
- String.Manipulation.cs
- Origem:
- String.Manipulation.cs
- Origem:
- String.Manipulation.cs
- Origem:
- String.Manipulation.cs
Remove todos os caracteres de espaço em branco finais da cadeia atual.
public:
System::String ^ TrimEnd();
public string TrimEnd();
member this.TrimEnd : unit -> string
Public Function TrimEnd () As String
Devoluções
A cadeia que permanece após todos os caracteres de espaço branco serem removidos do final da cadeia atual. Se nenhum carácter puder ser cortado da instância atual, o método devolve a instância atual inalterada.
Observações
O TrimEnd método remove da cadeia atual todos os caracteres de espaço em branco posteriores. A operação de corte termina quando o primeiro carácter que não é de espaço em branco é encontrado no final da cadeia. Por exemplo, se a cadeia atual for "abc xyz", o TrimEnd método devolve " abc xyz".
Note
Se o TrimEnd método remover quaisquer caracteres da instância atual, este método não modifica o valor da instância atual. Em vez disso, devolve uma nova cadeia em que todos os caracteres de espaço em branco finais são removidos da cadeia atual.
Aplica-se a
TrimEnd(Char)
- Origem:
- String.Manipulation.cs
- Origem:
- String.Manipulation.cs
- Origem:
- String.Manipulation.cs
- Origem:
- String.Manipulation.cs
- Origem:
- String.Manipulation.cs
Remove todas as ocorrências finais de um carácter da cadeia 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 carácter Unicode para remover.
Devoluções
A cadeia que permanece após todas as ocorrências do trimChar carácter é removida do final da cadeia atual. Se nenhum carácter puder ser cortado da instância atual, o método devolve a instância atual inalterada.
Observações
O TrimEnd(System.Char) método remove da cadeia atual todos os caracteres de final trimChar . A operação de corte termina quando o primeiro carácter que não trimChar está é encontrado no final da cadeia. Por exemplo, se trimChar for - e a cadeia atual for "---abc---xyz----", o TrimEnd(System.Char) método devolve "---abc---xyz".
Note
Se o TrimEnd(System.Char) método remover quaisquer caracteres da instância atual, este método não modifica o valor da instância atual. Em vez disso, devolve uma nova cadeia em que todos os caracteres finais trimChar são removidos da cadeia atual.
Aplica-se a
TrimEnd(Char[])
- Origem:
- String.Manipulation.cs
- Origem:
- String.Manipulation.cs
- Origem:
- String.Manipulation.cs
- Origem:
- String.Manipulation.cs
- Origem:
- String.Manipulation.cs
Remove todas as ocorrências finais de um conjunto de caracteres especificados num array da cadeia atual.
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
Parâmetros
- trimChars
- Char[]
Um array de caracteres Unicode para remover, ou null.
Devoluções
A cadeia que permanece após todas as ocorrências dos caracteres no trimChars parâmetro serem removidas do final da cadeia atual. Se trimChars for null for ou um array vazio, os caracteres de espaço em branco Unicode são removidos em vez disso. Se nenhum carácter puder ser cortado da instância atual, o método devolve a instância atual inalterada.
Exemplos
O exemplo seguinte demonstra como pode usar o TrimEnd(System.Char[]) método para cortar espaços em branco ou sinais de pontuação do final de uma corda.
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
Observações
O TrimEnd(System.Char[]) método remove da cadeia atual todos os caracteres finais que estão no trimChars parâmetro. A operação de corte termina quando o primeiro carácter que não está presente trimChars é encontrado no final da sequência. Por exemplo, se a cadeia atual for "123abc456xyz789" e trimChars contiver os dígitos de "1" a "9", o TrimEnd(System.Char[]) método devolve "123abc456xyz".
Note
Se o TrimEnd(System.Char[]) método remover quaisquer caracteres da instância atual, este método não modifica o valor da instância atual. Em vez disso, devolve uma nova cadeia em que todos os caracteres finais encontrados em trimChars são removidos da cadeia atual.
Notas para Chamadores
O .NET Framework 3.5 SP1 e versões anteriores mantém uma lista interna de caracteres em branco que este método elimina se trimChars for null ou um array vazio. A partir do .NET Framework 4, se trimChars for null ou um array vazio, o método corta todos os caracteres em branco Unicode (ou seja, caracteres que produzem um valor de retorno true quando são passados para o método IsWhiteSpace(Char)). Devido a esta alteração, o método Trim() 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 método Trim() no .NET Framework 4 e versões posteriores não remove. Além disso, o método Trim() no .NET Framework 3.5 SP1 e versões anteriores não elimina três caracteres de espaço em branco Unicode: SEPARADOR VOCÁLICO MONGOL (U+180E), ESPAÇO NO-BREAK ESTREITO (U+202F) e ESPAÇO MATEMÁTICO MÉDIO (U+205F).