String.Remove Método

Definição

Namespace:: System

Assemblies:: mscorlib.dll, System.Runtime.dll

Assemblies:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Retorna uma nova cadeia de caracteres na qual um número especificado de caracteres da cadeia de caracteres atual é excluído.

Sobrecargas

Nome	Description
Remove(Int32, Int32)	Retorna uma nova cadeia de caracteres na qual um número especificado de caracteres na instância atual começando em uma posição especificada foi excluído.
Remove(Int32)	Retorna uma nova cadeia de caracteres na qual todos os caracteres na instância atual, começando em uma posição especificada e continuando até a última posição, foram excluídos.

Remove(Int32, Int32)

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Retorna uma nova cadeia de caracteres na qual um número especificado de caracteres na instância atual começando em uma posição especificada foi excluído.

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 baseada em zero para começar a excluir caracteres.

count: Int32

O número de caracteres a serem excluídos.

Retornos

String

Uma nova cadeia de caracteres equivalente a essa instância, exceto para os caracteres removidos.

Exceções

ArgumentOutOfRangeException

startIndex Ou count é menor que zero.

- ou -

startIndex além de count especificar uma posição fora dessa instância.

Exemplos

O exemplo a seguir demonstra como você 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'

Comentários

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

Note

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

Confira 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

Retorna uma nova cadeia de caracteres na qual todos os caracteres na instância atual, começando em uma posição especificada e continuando até a última posição, foram excluídos.

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 baseada em zero para começar a excluir caracteres.

Retornos

String

Uma nova cadeia de caracteres equivalente a essa cadeia de caracteres, exceto para os caracteres removidos.

Exceções

ArgumentOutOfRangeException

startIndex é menor que zero.

- ou -

startIndex é maior que o comprimento desta instância.

Exemplos

O exemplo a seguir demonstra o Remove método. O último caso remove todo o texto que começa do índice especificado até o final da cadeia de caracteres. O último caso remove três caracteres começando 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
'

Comentários

No .NET Framework, as cadeias de caracteres são baseadas em zero. O valor do startIndex parâmetro pode variar de zero ao comprimento da instância da cadeia de caracteres.

Note

Esse método não modifica o valor da instância atual. Em vez disso, retorna uma nova cadeia de caracteres na qual todos os caracteres da posição startIndex até o final da cadeia de caracteres original foram removidos.

Confira também

Aplica-se a

Comentários

Esta página foi útil?