Compartilhar via


Método ITextBuffer.Replace

Substitui uma seqüência de caracteres de texto diferente. Isso é equivalente ao primeiro excluir o texto a ser substituído e, em seguida, inserindo o novo texto.

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

Sintaxe

'Declaração
Function Replace ( _
    replaceSpan As Span, _
    replaceWith As String _
) As ITextSnapshot
ITextSnapshot Replace(
    Span replaceSpan,
    string replaceWith
)
ITextSnapshot^ Replace(
    Span replaceSpan, 
    String^ replaceWith
)
abstract Replace : 
        replaceSpan:Span * 
        replaceWith:string -> ITextSnapshot
function Replace(
    replaceSpan : Span, 
    replaceWith : String
) : ITextSnapshot

Parâmetros

  • replaceWith
    Tipo: String

    O novo texto para substituir o antigo.

Valor de retorno

Tipo: Microsoft.VisualStudio.Text.ITextSnapshot
O ITextSnapshot.

Exceções

Exceção Condição
ArgumentNullException

replaceWith é nulluma referência nula (Nothing no Visual Basic).

InvalidOperationException

Uma edição de texto está ativa.

ArgumentOutOfRangeException

replaceSpan.End é maior que o comprimento do buffer.

Comentários

Este é um atalho para a criação de uma nova ITextEdit objeto, usá-lo para substituir o texto e depois aplicá-la. Se a substituição falhar por conta de uma região de somente leitura, o instantâneo retornado será o mesmo que o instantâneo atual do buffer antes da substituição de tentativa.

Segurança do .NET Framework

Consulte também

Referência

ITextBuffer Interface

Namespace Microsoft.VisualStudio.Text