String.TrimEnd Método

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Sobrecargas

TrimEnd()	Quita todos los caracteres de espacio en blanco del final de la cadena actual.
TrimEnd(Char)	Quita todas las repeticiones finales de un carácter de la cadena actual.
TrimEnd(Char[])	Quita todas las repeticiones del final de un conjunto de caracteres especificados en una matriz de la cadena actual.

TrimEnd()

Source:

String.Manipulation.cs

Quita todos los caracteres de espacio en blanco del final de la cadena actual.

public:
 System::String ^ TrimEnd();

public string TrimEnd ();

member this.TrimEnd : unit -> string

Public Function TrimEnd () As String

Devoluciones

String

La cadena que queda después de quitar todos los caracteres de espacio en blanco del final de la cadena actual. Si no se puede quitar ningún carácter de la instancia actual, el método devuelve la instancia actual sin cambios.

Comentarios

El TrimEnd método quita de la cadena actual todos los caracteres de espacio en blanco finales. La operación de recorte se detiene cuando se encuentra el primer carácter que no es de espacio en blanco al final de la cadena. Por ejemplo, si la cadena actual es " abc xyz ", el TrimEnd método devuelve " abc xyz".

Nota

Si el TrimEnd método quita los caracteres de la instancia actual, este método no modifica el valor de la instancia actual. En su lugar, devuelve una nueva cadena en la que se quitan todos los caracteres de espacio en blanco finales de la cadena actual.

TrimEnd(Char)

Source:

String.Manipulation.cs

Quita todas las repeticiones finales de un carácter de la cadena actual.

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

Un carácter Unicode que se va a quitar.

Devoluciones

String

La cadena que queda después de quitar todas las repeticiones del carácter trimChar del final de la cadena actual. Si no se puede quitar ningún carácter de la instancia actual, el método devuelve la instancia actual sin cambios.

Comentarios

El TrimEnd(System.Char) método quita de la cadena actual todos los caracteres finales trimChar . La operación de recorte se detiene cuando se encuentra el primer carácter que no trimChar se encuentra al final de la cadena. Por ejemplo, si trimChar es - y la cadena actual es "---abc---xyz----", el TrimEnd(System.Char) método devuelve "---abc---xyz".

Nota

Si el TrimEnd(System.Char) método quita los caracteres de la instancia actual, este método no modifica el valor de la instancia actual. En su lugar, devuelve una nueva cadena en la que se quitan todos los caracteres finales trimChar de la cadena actual.

TrimEnd(Char[])

Source:

String.Manipulation.cs

Quita todas las repeticiones del final de un conjunto de caracteres especificados en una matriz de la cadena actual.

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[]

Matriz de caracteres Unicode que se van a quitar, o null.

Devoluciones

String

Cadena que queda una vez quitadas todas las apariciones de los caracteres especificados por el parámetro trimChars del final de la cadena actual. Si trimChars es null o una matriz vacía, se quitarán los caracteres de espacio en blanco de Unicode. Si no se puede quitar ningún carácter de la instancia actual, el método devuelve la instancia actual sin cambios.

Ejemplos

En el ejemplo siguiente se muestra cómo puede usar el TrimEnd(System.Char[]) método para recortar los espacios en blanco o las marcas de puntuación desde el final de una cadena.

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

Comentarios

El TrimEnd(System.Char[]) método quita de la cadena actual todos los caracteres finales que están en el trimChars parámetro . La operación de recorte se detiene cuando se encuentra el primer carácter que no está en trimChars al final de la cadena. Por ejemplo, si la cadena actual es "123abc456xyz789" y trimChars contiene los dígitos de "1" a "9", el TrimEnd(System.Char[]) método devuelve "123abc456xyz".

Nota

Si el TrimEnd(System.Char[]) método quita los caracteres de la instancia actual, este método no modifica el valor de la instancia actual. En su lugar, devuelve una nueva cadena en la que se quitan todos los caracteres finales de trimChars la cadena actual.

Notas a los autores de las llamadas

.NET Framework 3.5 SP1 y versiones anteriores mantienen una lista interna de caracteres de espacio en blanco que este método recorta si trimChars es null o una matriz vacía. A partir de .NET Framework 4, si trimChars es null o una matriz vacía, el método recorta todos los caracteres de espacio en blanco Unicode (es decir, caracteres que generan un true valor devuelto cuando se pasan al IsWhiteSpace(Char) método). Debido a este cambio, el Trim() método de .NET Framework 3.5 SP1 y versiones anteriores quita dos caracteres, ZERO WIDTH SPACE (U+200B) y ZERO WIDTH NO-BREAK SPACE (U+FEFF), que el Trim() método de .NET Framework 4 y versiones posteriores no quita. Además, el Trim() método de .NET Framework 3.5 SP1 y versiones anteriores no recorta tres caracteres de espacio en blanco Unicode: SEPARATOR DE VOWEL MONGOLIAN (U+180E), NARROW NO-BREAK SPACE (U+202F) y MEDIUM MATHEMATICAL SPACE (U+205F).

Consulte también

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