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

Definición

Sobrecargas

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

Quita todas las apariciones del final de un conjunto de caracteres especificados en una matriz del objeto String actual.Removes all trailing occurrences of a set of characters specified in an array from the current String object.

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

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

Devoluciones

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

Devoluciones

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

Quita todas las apariciones del final de un conjunto de caracteres especificados en una matriz del objeto String actual.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[]

Matriz de caracteres Unicode que se van a quitar, o null.An array of Unicode characters to remove, or null.

Devoluciones

Cadena que queda una vez quitadas todas las apariciones de los caracteres especificados por el parámetro trimChars del final de la cadena actual.The string that remains after all occurrences of the characters in the trimChars parameter are removed from the end of the current string. Si trimChars es null o una matriz vacía, se quitarán los caracteres de espacio en blanco de Unicode.If trimChars is null or an empty array, Unicode white-space characters are removed instead. Si no se puede quitar ningún carácter de la instancia actual, el método devuelve la instancia actual sin cambios.If no characters can be trimmed from the current instance, the method returns the current instance unchanged.

Ejemplos

El ejemplo siguiente muestra cómo puede usar el TrimEnd(Char[]) método recortar espacios en blanco o signos de puntuación del final de una cadena.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

Comentarios

El TrimEnd método quita de la cadena actual todos los caracteres finales que se encuentran en el trimChars parámetro.The TrimEnd method removes from the current string all trailing characters that are in the trimChars parameter. La operación de recorte se detiene cuando el primer carácter que no está en trimChars se encuentra al final de la cadena.The trim operation stops when the first character that is not in trimChars is encountered at the end of the string. Por ejemplo, si la cadena actual es "123abc456xyz789" y trimChars contiene los dígitos de "1" al "9", el TrimEnd método devuelve "123abc456xyz".For example, if the current string is "123abc456xyz789" and trimChars contains the digits from "1" through "9", the TrimEnd method returns "123abc456xyz".

Nota

Si el TrimEnd método quita los caracteres de la instancia actual, este método no modifica el valor de la instancia actual.If the TrimEnd method removes any characters from the current instance, this method does not modify the value of the current instance. En su lugar, devuelve una nueva cadena en que al final de todos los caracteres que se encuentren en trimChars se quitan de la cadena actual.Instead, it returns a new string in which all trailing characters found in trimChars are removed from the current string.

Notas a los autores de las llamadas

El .NET Framework 3.5 SP1.NET Framework 3.5 SP1 y versiones anteriores se mantiene una lista interna de caracteres de espacio en blanco que recorta este método si trimChars es null o una matriz vacía.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. A partir de la .NET Framework 4.NET Framework 4si trimChars es null o una matriz vacía, el método recorta todos los caracteres de espacio en blanco de Unicode (es decir, los caracteres que producen un true valor devuelto cuando se pasan a la 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). Debido a este cambio, el Trim() método en el .NET Framework 3.5 SP1.NET Framework 3.5 SP1 y versiones anteriores se quitan dos caracteres, espacio de ancho cero (200B) y el espacio de NO separación de ancho cero (U+FEFF), que el Trim() método en el .NET Framework 4.NET Framework 4 y versiones posteriores No quitar.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. Además, el Trim() método en el .NET Framework 3.5 SP1.NET Framework 3.5 SP1 y versiones anteriores no recorta los tres caracteres de espacio en blanco de Unicode: SEPARADOR de vocal mongol (180E), espacio de NO separación estrecha (202F) y espacio matemático intermedio (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).

Consulte también:

Se aplica a