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: Int32A posição do buffer no qual se inicia a substituição.
charsToReplace
Tipo: Int32O número de caracteres para substituir.
replaceWith
Tipo: StringO 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
- 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.