String.Remove Método

Definição

Espaço de Nomes:
System
Assemblagens:
mscorlib.dll, System.Runtime.dll
Assemblagens:
netstandard.dll, System.Runtime.dll
Assemblagem:
System.Runtime.dll
Assemblagem:
mscorlib.dll
Assemblagem:
netstandard.dll

Devolve uma nova cadeia em que um número especificado de caracteres da cadeia atual é eliminado.

Sobrecargas

Name Description
Remove(Int32, Int32)

Devolve uma nova cadeia em que um número especificado de caracteres na instância atual a partir de uma posição determinada foi eliminado.
Remove(Int32)

Devolve uma nova cadeia em que todos os caracteres da instância atual, começando numa posição especificada e continuando até à última posição, foram eliminados.

Remove(Int32, Int32)

Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs

Devolve uma nova cadeia em que um número especificado de caracteres na instância atual a partir de uma posição determinada foi eliminado.

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

A posição de base zero para começar a eliminar personagens.

count
Int32

O número de caracteres a apagar.

Devoluções

String

Uma nova cadeia que é equivalente a esta instância, exceto pelos caracteres removidos.

Exceções

ArgumentOutOfRangeException

Ou startIndexcount é menor que zero.

-ou-

startIndex Além disso count , especifica uma posição fora desta situação.

Exemplos

O exemplo seguinte demonstra como pode remover o nome do meio de um nome 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'

Observações

No framework .NET, as strings são baseadas em zero. O valor do startIndex parâmetro pode variar de zero a um a menos do que o comprimento da instância da cadeia.

Note

Este método não modifica o valor da instância atual. Em vez disso, devolve uma nova cadeia em que o número de caracteres especificados pelo count parâmetro foi removido. Os caracteres são removidos na posição especificada por startIndex.

Ver também

Aplica-se a

Remove(Int32)

Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs

Devolve uma nova cadeia em que todos os caracteres da instância atual, começando numa posição especificada e continuando até à última posição, foram eliminados.

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

A posição de base zero para começar a eliminar personagens.

Devoluções

String

Uma nova cadeia que é equivalente a esta cadeia, exceto pelos caracteres removidos.

Exceções

ArgumentOutOfRangeException

startIndex é inferior a zero.

-ou-

startIndex é maior do que o comprimento desta instância.

Exemplos

O exemplo seguinte demonstra o Remove método. O penúltimo caso remove todo o texto desde o índice especificado até ao fim da cadeia. O último caso remove três caracteres a partir do í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
'

Observações

No framework .NET, as strings são baseadas em zero. O valor do startIndex parâmetro pode variar de zero até ao comprimento da instância da cadeia.

Note

Este método não modifica o valor da instância atual. Em vez disso, devolve uma nova cadeia em que todos os caracteres da posição startIndex até ao fim da cadeia original foram removidos.

Ver também

Aplica-se a