Freigeben über


EditPoint2.ReplacePattern-Methode (TextPoint, String, String, Int32, TextRanges%)

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

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

Syntax

'Declaration
Function ReplacePattern ( _
    Point As TextPoint, _
    Pattern As String, _
    Replace As String, _
    vsFindOptionsValue As Integer, _
    <OutAttribute> ByRef Tags As TextRanges _
) As Boolean
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
)
abstract ReplacePattern : 
        Point:TextPoint * 
        Pattern:string * 
        Replace:string * 
        vsFindOptionsValue:int * 
        Tags:TextRanges byref -> bool 
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 enthält, enthält Tags eine Auflistung von TextRange-Objekten, und zwar jeweils eines für jeden markierten Unterausdruck.

Rückgabewert

Typ: System.Boolean
true , wenn die Ersetzung erfolgreich ist; andernfalls false.

Hinweise

ReplacePattern sucht wie FindPattern nach Text, wobei allerdings nur Text zwischen dem Bearbeitungspunkt und dem Point des Arguments durchsucht wird.Wenn Suchen und Ersetzen auf das gesamte Dokument angewendet werden soll, wird TextDocument.ReplacePattern verwendet.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

.NET Framework-Sicherheit

Siehe auch

Referenz

EditPoint2 Schnittstelle

ReplacePattern-Überladung

EnvDTE80-Namespace