Metodo TextSelection.ReplacePattern

  • Articolo

Sostituisce il testo corrispondente al criterio di ricerca in un intero documento di testo.

Spazio dei nomi:  EnvDTE
Assembly:  EnvDTE (in EnvDTE.dll)

Sintassi

'Dichiarazione
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

Parametri

  • Pattern
    Tipo: System.String
    Obbligatorio.La stringa da trovare.
  • Replace
    Tipo: System.String
    Obbligatorio.Il testo con cui sostituire ogni occorrenza di Pattern.
  • vsFindOptionsValue
    Tipo: System.Int32
    Facoltativo.Una costante vsFindOptions che specifica il comportamento del metodo ReplacePattern, ad esempio la modalità di ricerca, il punto di inizio della ricerca, la direzione della ricerca e la rilevanza dell'utilizzo delle maiuscole e delle minuscole.
  • Tags
    Tipo: EnvDTE.TextRanges%
    Facoltativo.Insieme TextRanges.Se il criterio di ricerca è un'espressione regolare e contiene delle sottoespressioni con tag, Tags conterrà un insieme di oggetti EditPoint, uno per ogni sottoespressione con tag.

Valore restituito

Tipo: System.Boolean
Un valore Boolean.

Note

Il metodo ReplacePattern applicato all'oggetto TextDocument esegue la sostituzione del testo come il metodo ReplacePattern applicato all'oggetto TextSelection, ma agisce sull'intero documento di testo e non solo sul testo selezionato.

Il metodo ReplacePattern per Visual Studio non è compatibile con versioni precedenti del metodo ReplacePattern, perché ora la sintassi delle espressioni regolari è diversa.

Esempi

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);
    }
}

Sicurezza di .NET Framework

Vedere anche

Riferimenti

TextSelection Interfaccia

Spazio dei nomi EnvDTE

Altre risorse

Procedura: compilare ed eseguire gli esempi di codice del modello a oggetti di automazione