String.Remove Método

Definición

Devuelve una nueva cadena en la que se elimina un número especificado de caracteres de la cadena actual.

Sobrecargas

Nombre Description
Remove(Int32, Int32)

Devuelve una nueva cadena en la que se ha eliminado un número especificado de caracteres de la instancia actual que comienza en una posición especificada.

Remove(Int32)

Devuelve una nueva cadena en la que se han eliminado todos los caracteres de la instancia actual, comenzando en una posición especificada y continuando por la última posición.

Remove(Int32, Int32)

Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs

Devuelve una nueva cadena en la que se ha eliminado un número especificado de caracteres de la instancia actual que comienza en una posición especificada.

public:
 System::String ^ Remove(int startIndex, int count);
public string Remove(int startIndex, int count);
member this.Remove : int * int -> string
Public Function Remove (startIndex As Integer, count As Integer) As String

Parámetros

startIndex
Int32

Posición de base cero para empezar a eliminar caracteres.

count
Int32

Número de caracteres que se van a eliminar.

Devoluciones

Nueva cadena que es equivalente a esta instancia, excepto los caracteres quitados.

Excepciones

O es startIndex menor que count cero.

O bien

startIndex además count , especifique una posición fuera de esta instancia.

Ejemplos

En el ejemplo siguiente se muestra cómo puede quitar el nombre intermedio de un nombre completo.

using System;

public class RemoveTest
{
    public static void Main()
    {

        string name = "Michelle Violet Banks";

        Console.WriteLine("The entire name is '{0}'", name);

        // Remove the middle name, identified by finding the spaces in the name.
        int foundS1 = name.IndexOf(" ");
        int foundS2 = name.IndexOf(" ", foundS1 + 1);

        if (foundS1 != foundS2 && foundS1 >= 0)
        {
            name = name.Remove(foundS1 + 1, foundS2 - foundS1);

            Console.WriteLine("After removing the middle name, we are left with '{0}'", name);
        }
    }
}
// The example displays the following output:
//       The entire name is 'Michelle Violet Banks'
//       After removing the middle name, we are left with 'Michelle Banks'
let name = "Michelle Violet Banks"

printfn $"The entire name is '{name}'"

// Remove the middle name, identified by finding the spaces in the name.
let foundS1 = name.IndexOf " "
let foundS2 = name.IndexOf(" ", foundS1 + 1)

if foundS1 <> foundS2 && foundS1 >= 0 then
    let name = name.Remove(foundS1 + 1, foundS2 - foundS1)

    printfn $"After removing the middle name, we are left with '{name}'"
// The example displays the following output:
//       The entire name is 'Michelle Violet Banks'
//       After removing the middle name, we are left with 'Michelle Banks'
Public Class RemoveTest
    
    Public Shared Sub Main()
        Dim name As String = "Michelle Violet Banks"
                
        Console.WriteLine("The entire name is '{0}'", name)
        Dim foundS1 As Integer = name.IndexOf(" ")
        Dim foundS2 As Integer = name.IndexOf(" ", foundS1 + 1)
        If foundS1 <> foundS2 And foundS1 >= 0 Then
            
            ' remove the middle name, identified by finding the spaces in the middle of the name...    
            name = name.Remove(foundS1 + 1, foundS2 - foundS1)
            
            Console.WriteLine("After removing the middle name, we are left with '{0}'", name)
        End If
    End Sub
End Class 
' The example displays the following output:
'       The entire name is 'Michelle Violet Banks'
'       After removing the middle name, we are left with 'Michelle Banks'

Comentarios

En .NET Framework, las cadenas se basan en cero. El valor del startIndex parámetro puede oscilar entre cero y uno menor que la longitud de la instancia de cadena.

Note

Este método no modifica el valor de la instancia actual. En su lugar, devuelve una nueva cadena en la que se ha quitado el número de caracteres especificados por el count parámetro. Los caracteres se quitan en la posición especificada por startIndex.

Consulte también

Se aplica a

Remove(Int32)

Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs

Devuelve una nueva cadena en la que se han eliminado todos los caracteres de la instancia actual, comenzando en una posición especificada y continuando por la última posición.

public:
 System::String ^ Remove(int startIndex);
public string Remove(int startIndex);
member this.Remove : int -> string
Public Function Remove (startIndex As Integer) As String

Parámetros

startIndex
Int32

Posición de base cero para empezar a eliminar caracteres.

Devoluciones

Nueva cadena que es equivalente a esta cadena, excepto los caracteres quitados.

Excepciones

startIndex es menor que cero.

O bien

startIndex es mayor que la longitud de esta instancia.

Ejemplos

En el ejemplo siguiente se muestra el Remove método . El caso siguiente a último quita todo el texto a partir del índice especificado hasta el final de la cadena. El último caso quita tres caracteres a partir del índice especificado.

// This example demonstrates the String.Remove() method.
using System;

class Sample
{
    public static void Main()
    {
        string s = "abc---def";

        Console.WriteLine("Index: 012345678");
        Console.WriteLine("1)     {0}", s);
        Console.WriteLine("2)     {0}", s.Remove(3));
        Console.WriteLine("3)     {0}", s.Remove(3, 3));
    }
}
/*
This example produces the following results:

Index: 012345678
1)     abc---def
2)     abc
3)     abcdef

*/
// This example demonstrates the String.Remove() method.
let s = "abc---def"

printfn "Index: 012345678"
printfn $"1)     {s}"
printfn $"2)     {s.Remove 3}"
printfn $"3)     {s.Remove(3, 3)}"
(*
This example produces the following results:

Index: 012345678
1)     abc---def
2)     abc
3)     abcdef

*)
' This example demonstrates the String.Remove() method.
Class Sample
   Public Shared Sub Main()
      Dim s As String = "abc---def"
      '
      Console.WriteLine("Index: 012345678")
      Console.WriteLine("1)     {0}", s)
      Console.WriteLine("2)     {0}", s.Remove(3))
      Console.WriteLine("3)     {0}", s.Remove(3, 3))
   End Sub
End Class
'
'This example produces the following results:
'
'Index: 012345678
'1)     abc---def
'2)     abc
'3)     abcdef
'

Comentarios

En .NET Framework, las cadenas se basan en cero. El valor del startIndex parámetro puede oscilar entre cero y la longitud de la instancia de cadena.

Note

Este método no modifica el valor de la instancia actual. En su lugar, devuelve una nueva cadena en la que se han quitado todos los caracteres de posición startIndex al final de la cadena original.

Consulte también

Se aplica a