Método TextSelection.ReplacePattern

Artigo
05/17/2015

Substitui o texto correspondente em todo um documento de texto inteiro.

Namespace: EnvDTE
Assembly: EnvDTE (em EnvDTE.dll)

Sintaxe

'Declaração
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

Parâmetros

Pattern
Tipo: String

Obrigatório. A cadeia de caracteres a localizar.

Replace
Tipo: String

Obrigatório. O texto para substituir cada ocorrência de Pattern.

vsFindOptionsValue
Tipo: Int32

Opcional. Uma constante de vsFindOptions que indica o comportamento de ReplacePattern, como como procurar, onde começar a pesquisa, se deve-se procurar frente ou para trás, e a diferenciação de maiúsculas e minúsculas.

Tags
Tipo: EnvDTE.TextRanges%

Opcional. Uma coleção de TextRanges. Se o padrão correspondente de texto é uma expressão regular e contém subexpressões etiquetadas, então Tags contém uma coleção de objetos de EditPoint , um para cada etiquetada subexpressão.

Valor de retorno

Tipo: Boolean
Um valor booliano.

Comentários

ReplacePattern para o objeto de TextDocument substitui o texto como ReplacePattern para o objeto de TextSelection , mas opera em geral o documento de texto em vez de apenas a seleção de texto.

O método de ReplacePattern para Visual Studio é incompatível com versões anteriores do método de ReplacePattern , porque as expressões regulares têm agora uma sintaxe diferente.

Exemplos

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

TextSelection Interface

Namespace EnvDTE

Outros recursos

Como compilar e executar os exemplos de código do modelo de objeto Automation

Partilhar via