Partager via


TextDocument.ReplacePattern, méthode

Remplace le texte correspondant dans l'intégralité du texte d'un document.

Espace de noms :  EnvDTE
Assembly :  EnvDTE (dans EnvDTE.dll)

Syntaxe

'Déclaration
Function ReplacePattern ( _
    Pattern As String, _
    Replace As String, _
    vsFindOptionsValue As Integer, _
    <OutAttribute> ByRef Tags As TextRanges _
) As Boolean
bool ReplacePattern(
    string Pattern,
    string Replace,
    int vsFindOptionsValue,
    out TextRanges Tags
)
bool ReplacePattern(
    [InAttribute] String^ Pattern, 
    [InAttribute] String^ Replace, 
    [InAttribute] int vsFindOptionsValue, 
    [InAttribute] [OutAttribute] TextRanges^% Tags
)
abstract ReplacePattern : 
        Pattern:string * 
        Replace:string * 
        vsFindOptionsValue:int * 
        Tags:TextRanges byref -> bool
function ReplacePattern(
    Pattern : String, 
    Replace : String, 
    vsFindOptionsValue : int, 
    Tags : TextRanges
) : boolean

Paramètres

  • Pattern
    Type : String

    Obligatoire. Chaîne à rechercher.

  • Replace
    Type : String

    Obligatoire. Texte par lequel remplacer chaque occurrence de Pattern.

  • vsFindOptionsValue
    Type : Int32

    Optionnel. Constante vsFindOptions indiquant le comportement de ReplacePattern, par exemple comment effectuer la recherche, où commencer la recherche, dans quel sens effectuer la recherche et si la recherche respecte la casse.

  • Tags
    Type : EnvDTE.TextRanges%

    Optionnel. Collection TextRanges. Si le modèle de texte correspondant est une expression régulière et contient des sous-expressions avec balises, Tags contient une collection d'objets EditPoint, un pour chaque sous-expression avec balises.

Valeur de retour

Type : Boolean
Valeur booléenne.

Notes

ReplacePattern pour l'objet TextDocument remplace du texte comme ReplacePattern pour l'objet TextSelection, mais il opère sur l'intégralité du document texte plutôt que sur du texte sélectionné uniquement.

La méthode ReplacePattern pour Visual Studio 2005 est incompatible avec les versions antérieures de la méthode ReplacePattern, parce que les expressions régulières ont désormais une syntaxe différente.

Exemples

Sub ReplacePatternExample(dte As DTE)

    ' Create a new text file and insert 10 lines of text.
    dte.ItemOperations.NewFile()
    Dim txtSel As TextSelection = _
        CType(dte.ActiveDocument.Selection, TextSelection)
    Dim txtDoc As TextDocument = _
        CType(dte.ActiveDocument.Object(), TextDocument)
    Dim editPnt As EditPoint = txtDoc.StartPoint.CreateEditPoint()
    Dim i As Integer
    For i = 1 To 10
        editPnt.Insert("This is a test." & vbCrLf)
    Next i

    If MsgBox("Replace 'test' with 'done deal'?", vbYesNo) = _
        MsgBoxResult.Yes Then
        txtSel.SelectAll()
        txtSel.ReplacePattern("test", "done deal")
    End If

End Sub
public void ReplacePatternExample(DTE dte)
{
    // Create a new text file and insert 10 lines of text.
    dte.ItemOperations.NewFile(@"General\Text File", "", 
        Constants.vsViewKindPrimary);
    TextSelection txtSel = (TextSelection)dte.ActiveDocument.Selection;
    TextDocument txtDoc = (TextDocument)dte.ActiveDocument.Object("");
    EditPoint editPnt = txtDoc.StartPoint.CreateEditPoint();
    for (int i = 1; i <= 10; i++)
    {
        editPnt.Insert("This is a test." + Environment.NewLine);
    }

    if (MessageBox.Show("Replace 'test' with 'done deal'?", "", 
        MessageBoxButtons.YesNo) == DialogResult.Yes)
    {
        TextRanges dummy = null;
        txtSel.SelectAll();
        txtSel.ReplacePattern("test", "done deal", 
            (int)vsFindOptions.vsFindOptionsNone, ref dummy);
    }
}

Sécurité .NET Framework

Voir aussi

Référence

TextDocument Interface

EnvDTE, espace de noms

Autres ressources

Comment : compiler et exécuter les exemples de code du modèle objet Automation