ITextBuffer.Replace, méthode
Remplace une séquence de caractères avec du texte différent. Ceci équivaut à supprimer en premier le texte à remplacer et à insérer un nouveau texte.
Espace de noms : Microsoft.VisualStudio.Text
Assembly : Microsoft.VisualStudio.Text.Data (dans Microsoft.VisualStudio.Text.Data.dll)
Syntaxe
'Déclaration
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
Paramètres
replaceSpan
Type : Microsoft.VisualStudio.Text.SpanÉtendue des caractères à remplacer.
replaceWith
Type : StringNouveau texte remplaçant l'ancien.
Valeur de retour
Type : Microsoft.VisualStudio.Text.ITextSnapshot
ITextSnapshot .
Exceptions
Exception | Condition |
---|---|
ArgumentNullException | replaceWith a la valeur nullune référence null (Nothing en Visual Basic). |
InvalidOperationException | Une modification de texte est actuellement - active. |
ArgumentOutOfRangeException | replaceSpan. L'extrémité est plus supérieure à la longueur de la mémoire tampon. |
Notes
C'est un raccourci pour créer un nouvel objet d'ITextEdit, l'utiliser pour remplacer le texte, puis l'appliquer. Si le remplacement échoue à cause d'une zone en lecture seule, l'instantané retourné sera identique à l'instantané actuel de la mémoire tampon avant le remplacement tenté.
Sécurité .NET Framework
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.