Compartilhar via


Método ITextEdit.Replace (Int32, Int32, String)

Substitui uma seqüência de caracteres de texto diferente.

Namespace:  Microsoft.VisualStudio.Text
Assembly:  Microsoft.VisualStudio.Text.Data (em Microsoft.VisualStudio.Text.Data.dll)

Sintaxe

'Declaração
Function Replace ( _
    startPosition As Integer, _
    charsToReplace As Integer, _
    replaceWith As String _
) As Boolean
bool Replace(
    int startPosition,
    int charsToReplace,
    string replaceWith
)
bool Replace(
    int startPosition, 
    int charsToReplace, 
    String^ replaceWith
)
abstract Replace : 
        startPosition:int * 
        charsToReplace:int * 
        replaceWith:string -> bool
function Replace(
    startPosition : int, 
    charsToReplace : int, 
    replaceWith : String
) : boolean

Parâmetros

  • startPosition
    Tipo: Int32

    A posição do buffer no qual se inicia a substituição.

  • charsToReplace
    Tipo: Int32

    O número de caracteres para substituir.

  • replaceWith
    Tipo: String

    O novo texto.

Valor de retorno

Tipo: Boolean
true Se a substituição foi bem-sucedida. falseSe ele foi impedido por uma região de somente leitura.

Exceções

Exceção Condição
ArgumentNullException

replaceWithé nulo.

InvalidOperationException

O Apply ou Cancel ou Dispose método anteriormente foi chamado neste objeto.

ArgumentOutOfRangeException

startPositioné menor que zero ou maior que o comprimento do buffer, ou charsToReplace é menor que zero, ou startPosition + charsToReplace é maior que o comprimento do buffer.

Comentários

Este método tem o mesmo efeito que primeiro excluir o charsToReplace e, em seguida, inserir replaceWith.

Substituição de zero caracteres com uma seqüência vazia será bem-sucedida, mas não gerar um novo instantâneo ou elevar um Changed evento.

Segurança do .NET Framework

Consulte também

Referência

ITextEdit Interface

Sobrecargas Replace

Namespace Microsoft.VisualStudio.Text