Share via


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

  • replaceWith
    Type : String

    Nouveau 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

Voir aussi

Référence

ITextBuffer Interface

Microsoft.VisualStudio.Text, espace de noms