Método TextDocument.ReplacePattern

Artigo
10/26/2012

Substitui texto em um documento de texto inteiro correspondente.

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: System.String
Obrigatório.A seqüência de caracteres para localizar.

Replace
Tipo: System.String
Obrigatório.O texto para substituir cada ocorrência de Pattern.

vsFindOptionsValue
Tipo: System.Int32
Opcional.A vsFindOptions constante que indica o comportamento de ReplacePattern, como, por exemplo, como pesquisar, onde começar a pesquisa, se deve pesquisar frente ou para trás e se a pesquisa é diferencia maiúsculas de minúsculas.

Tags
Tipo: EnvDTE.TextRanges%
Opcional.A TextRanges coleção.Se o padrão de texto correspondente é uma expressão regular e contém subexpressões com marcas de formatação, em seguida, Tags contém uma coleção de EditPoint objetos, um para cada subexpressão com marcas de formatação.

Valor de retorno

Tipo: System.Boolean
Um valor booleano.

Comentários

ReplacePatternpara o TextDocument objeto substitui o texto como ReplacePattern para o TextSelection objeto, mas ele funciona com o documento de texto inteiro em vez de apenas o texto selecionado.

O ReplacePattern método para Visual Studio 2005 é incompatível com versões anteriores da ReplacePattern método, porque expressões regulares agora tem 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áveis.

Consulte também

Referência

TextDocument Interface

Namespace EnvDTE

Outros recursos

Como: compilar e executar os exemplos de código de modelo de objeto de automação

Compartilhar via