Metodo TextSelection.ReplacePattern

Articolo
05/16/2015

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: String

Obbligatorio. La stringa da trovare.

Replace
Tipo: String

Obbligatorio. Il testo con cui sostituire ogni occorrenza di Pattern.

vsFindOptionsValue
Tipo: Int32

Parametro 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%

Parametro facoltativo. Raccolta TextRanges. Se il criterio di ricerca è un'espressione regolare e contiene delle sottoespressioni con tag, Tags conterrà una raccolta di oggetti EditPoint, uno per ogni sottoespressione con tag.

Valore restituito

Tipo: Boolean
Un valore Boolean.

Note

ReplacePattern per l'oggetto TextDocument sostituisce il testo come ReplacePattern per l'oggetto TextSelection, ma funziona nel documento di testo anziché solo il 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 altre 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