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
replaceSpan
Tipo: Microsoft.VisualStudio.Text.SpanO intervalo de caracteres para substituir.
replaceWith
Tipo: StringO 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
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.