EditPoint.ReplacePattern-Methode

  • Artikel

Aktualisiert: November 2007

Sucht ein Muster im angegebenen Textbereich und ersetzt dieses durch den angegebenen Text.

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

Syntax

Function ReplacePattern ( _
    Point As TextPoint, _
    Pattern As String, _
    Replace As String, _
    vsFindOptionsValue As Integer, _
    <OutAttribute> ByRef Tags As TextRanges _
) As Boolean

Dim instance As EditPoint
Dim Point As TextPoint
Dim Pattern As String
Dim Replace As String
Dim vsFindOptionsValue As Integer
Dim Tags As TextRanges
Dim returnValue As Boolean

returnValue = instance.ReplacePattern(Point, _
    Pattern, Replace, vsFindOptionsValue, _
    Tags)

bool ReplacePattern(
    TextPoint Point,
    string Pattern,
    string Replace,
    int vsFindOptionsValue,
    out TextRanges Tags
)

bool ReplacePattern(
    [InAttribute] TextPoint^ Point, 
    [InAttribute] String^ Pattern, 
    [InAttribute] String^ Replace, 
    [InAttribute] int vsFindOptionsValue, 
    [InAttribute] [OutAttribute] TextRanges^% Tags
)

function ReplacePattern(
    Point : TextPoint, 
    Pattern : String, 
    Replace : String, 
    vsFindOptionsValue : int, 
    Tags : TextRanges
) : boolean

Parameter

  • Point
    Typ: EnvDTE.TextPoint

    Erforderlich. Der Endpunkt des angegebenen Textbereichs. Der Bearbeitungspunkt und Point sind die Begrenzungen für die Ersetzung.

  • Pattern
    Typ: System.String

    Erforderlich. Die zu suchende Zeichenfolge.

  • Replace
    Typ: System.String

    Erforderlich. Die Ersetzungszeichenfolge für Pattern.

  • Tags
    Typ: EnvDTE.TextRanges%

    Optional. Wenn das gesuchte Muster ein regulärer Ausdruck ist und markierte Unterausdrücke umfasst, enthält Tags eine Auflistung von TextRange-Objekten, jeweils eines für jeden markierten Unterausdruck.

Rückgabewert

Typ: System.Boolean

true, wenn die Ersetzung erfolgreich ausgeführt wird, und andernfalls false.

Hinweise

ReplacePattern sucht Text auf ähnliche Weise wie FindPattern, außer dass nur Text zwischen dem Bearbeitungspunkt und dem Point-Argument durchsucht wird. Um Text im gesamten Dokument zu suchen und zu ersetzen, verwenden Sie ReplacePattern. Die Tags-Auflistung gibt nur Informationen für das letzte gesuchte Muster zurück.

Beispiele

Sub ReplacePatternExample()
   Dim objTextDoc As TextDocument
   Dim objMovePt As EditPoint
   Dim objEditPt As EditPoint, iCtr As Integer

   ' Create a new text file.
   DTE.ItemOperations.NewFile("General\Text File")

   ' Get a handle to the new document and create an EditPoint.
   objTextDoc = DTE.ActiveDocument.Object("TextDocument")
   objMovePt = objTextDoc.EndPoint.CreateEditPoint
   objEditPt = objTextDoc.StartPoint.CreateEditPoint

   ' Insert ten lines of text.
   For iCtr = 1 To 10
      objEditPt.Insert("This is a test." & Chr(13))
   Next iCtr
   objEditPt.StartOfDocument()
   objMovePt.EndOfDocument()
   ' Replace all occurrences of "test" with "thing."
    objEditPt.ReplacePattern(objMovePt, "test", "thing", vsFindOptions.vsFindOptionsFromStart)
End Sub

Berechtigungen

Siehe auch

Referenz

EditPoint-Schnittstelle

EditPoint-Member

EnvDTE-Namespace