Metodo TextSelection.ReplacePattern

Articolo
08/11/2011

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

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

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

Condividi tramite