Freigeben über


Find2-Schnittstelle

Unterstützt allgemeine Find-Operationen für Text in Dokumenten und Dateien in der Umgebung.

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

Syntax

'Declaration
<GuidAttribute("01568308-5B2A-4F30-8D0A-E10EE0F28F4A")> _
Public Interface Find2 _
    Inherits Find
[GuidAttribute("01568308-5B2A-4F30-8D0A-E10EE0F28F4A")]
public interface Find2 : Find
[GuidAttribute(L"01568308-5B2A-4F30-8D0A-E10EE0F28F4A")]
public interface class Find2 : Find
[<GuidAttribute("01568308-5B2A-4F30-8D0A-E10EE0F28F4A")>]
type Find2 =  
    interface
        interface Find
    end
public interface Find2 extends Find

Der Find2-Typ macht die folgenden Member verfügbar.

Eigenschaften

  Name Beschreibung
Öffentliche Eigenschaft Action (Von Find geerbt.)
Öffentliche Eigenschaft Action Ruft die Art der Suche ab oder legt diese fest, z. B. Optionen zur Suche nach der nächsten Übereinstimmung, Alle suchen, Suchen und Ersetzen usw.
Öffentliche Eigenschaft Backwards (Von Find geerbt.)
Öffentliche Eigenschaft Backwards Ruft einen Wert, der angibt, ob die Suche ausgehend von der aktuellen Position rückwärts durchgeführt wird, oder legt diesen Wert fest.
Öffentliche Eigenschaft DTE (Von Find geerbt.)
Öffentliche Eigenschaft DTE Ruft das Erweiterbarkeitsobjekt der obersten Ebene ab.
Öffentliche Eigenschaft FilesOfType (Von Find geerbt.)
Öffentliche Eigenschaft FilesOfType Ruft die Dateierweiterung der zu durchsuchenden Dateien ab oder legt diese fest.
Öffentliche Eigenschaft FindWhat (Von Find geerbt.)
Öffentliche Eigenschaft FindWhat Ruft den zu suchenden Text oder das zu suchende Muster ab oder legt diesen fest.
Öffentliche Eigenschaft KeepModifiedDocumentsOpen (Von Find geerbt.)
Öffentliche Eigenschaft KeepModifiedDocumentsOpen Ruft einen Wert ab, der angibt, ob geänderte Dokumente nach einem Ersetzungsvorgang geöffnet bleiben, oder legt diesen Wert fest.
Öffentliche Eigenschaft MatchCase (Von Find geerbt.)
Öffentliche Eigenschaft MatchCase Ruft einen Wert ab, der angibt, ob die Groß- und Kleinschreibung bei der Suche berücksichtigt wird, oder legt diesen Wert fest.
Öffentliche Eigenschaft MatchInHiddenText (Von Find geerbt.)
Öffentliche Eigenschaft MatchInHiddenText Ruft einen Wert ab, der angibt, ob ausgeblendeter Text in die Suche einbezogen wird, oder legt diesen Wert fest.
Öffentliche Eigenschaft MatchWholeWord (Von Find geerbt.)
Öffentliche Eigenschaft MatchWholeWord Ruft einen Wert ab, der angibt, ob die Suche nur Übereinstimmungen für ganze Wörter findet.
Öffentliche Eigenschaft Parent (Von Find geerbt.)
Öffentliche Eigenschaft Parent Ruft das unmittelbar übergeordnete Objekt eines Find-Objekts ab.
Öffentliche Eigenschaft PatternSyntax (Von Find geerbt.)
Öffentliche Eigenschaft PatternSyntax Ruft die für die Angabe des Suchmusters verwendete Syntax ab oder legt diese fest.
Öffentliche Eigenschaft ReplaceWith (Von Find geerbt.)
Öffentliche Eigenschaft ReplaceWith Ruft den Ersetzungstext für eine Ersetzungsoperation ab oder legt diesen fest.
Öffentliche Eigenschaft ResultsLocation (Von Find geerbt.)
Öffentliche Eigenschaft ResultsLocation Ruft die Position ab, an der die Ergebnisse einer Massensuchoperation angezeigt werden, oder legt diese fest.
Öffentliche Eigenschaft SearchPath (Von Find geerbt.)
Öffentliche Eigenschaft SearchPath Ruft eine Liste der bei einer Suche in Dateien zu verwendenden Verzeichnisse ab oder legt diese fest.
Öffentliche Eigenschaft SearchSubfolders (Von Find geerbt.)
Öffentliche Eigenschaft SearchSubfolders Ruft einen Wert ab, der angibt, ob Unterordner in einen Suchvorgang eingeschlossen werden, oder legt diesen Wert fest.
Öffentliche Eigenschaft Target (Von Find geerbt.)
Öffentliche Eigenschaft Target Ruft das Ziel der Suchoperation ab, beispielsweise alle geöffneten Dokumente, Dateien, das aktive Dokument usw., oder legt es fest.
Öffentliche Eigenschaft WaitForFindToComplete Ruft einen Wert ab, der angibt, ob ein Suchergebnis vor dem Fortsetzen des Suchvorgangs zurückgegeben wird, oder legt diesen Wert fest.

Zum Seitenanfang

Methoden

  Name Beschreibung
Öffentliche Methode Execute() (Von Find geerbt.)
Öffentliche Methode Execute() Führt eine Suche basierend auf den Optionen aus, die für das Find-Objekt festgelegt sind.
Öffentliche Methode FindReplace(vsFindAction, String, Int32, String, vsFindTarget, String, String, vsFindResultsLocation) (Von Find geerbt.)
Öffentliche Methode FindReplace(vsFindAction, String, Int32, String, vsFindTarget, String, String, vsFindResultsLocation) Führt eine Such- oder Ersetzungsoperation anhand der Argumente der Methode durch, ohne die für das Find-Objekt festgelegten Optionen zu beeinflussen.

Zum Seitenanfang

Hinweise

Das Find-Objekt ermöglicht das Suchen und Ersetzen von Text in Bereichen der Umgebung, die diese Operationen unterstützen, wie dem Code-Editor.

Es ist in erster Linie für das Aufzeichnen von Makros vorgesehen.Der Makroaufzeichnungsmechanismus des Editors verwendet Find anstelle von TextSelection.FindPattern, sodass Sie die globale Suchfunktionalität anwenden können.Darüber hinaus ist er in der Regel nützlicher als die Verwendung des TextSelection-Objekts für Operationen wie Suchvorgänge in Dateien.

Die Visual Studio-Umgebung verfügt über einen globalen Suchzustand, der von allen Tools, die Suchfunktionen bereitstellen, gemeinsam genutzt wird.Beispielsweise nutzen alle Visual Studio-Elemente denselben Verlauf der während einer Sitzung verwendeten Suchmuster sowie die Information, ob die nächste Find-Operation für geöffnete Dokumente vorwärts oder rückwärts durchgeführt werden soll.Die Eigenschaften des Find-Objekts interagieren mit dem globalen Suchzustand und verfolgen diesen.Durch das Festlegen der Eigenschaften für das Find-Objekt legen Sie gleichzeitig den globalen Suchzustand fest.Wenn Benutzer eine Find-Operation in der Umgebung durchführen, wird die Art der durchgeführten Suche durch das Find-Objekt widergespiegelt.Da Automatisierungscode synchron mit dem UI-Thread der Umgebung ausgeführt wird, müssen Sie einige Eigenschaften nicht festlegen, und der Benutzer muss keine Suche durchführen, bevor Sie Execute aufrufen können.

Die Execute-Methode führt eine Find-Operation auf Grundlage der Einstellungen des Find-Objekts aus.Außerdem können Sie Argumente an die FindReplace-Methode übergeben, um eine Suche ohne Auswirkungen auf den globalen Suchzustand durchzuführen.Es ist wichtig, dass Automatisierungsclients eine Suche durchführen können, ohne den globalen Suchzustand oder das Umgebungszustandsmodell des Endbenutzers zu beeinflussen.

Beispiele

Sub FindExample()
   Dim objTextDoc As TextDocument
   Dim objEditPt As EditPoint
   Dim iCtr As Integer
   Dim objFind As Find

   ' 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")
   objEditPt = objTextDoc.StartPoint.CreateEditPoint
   objFind = objTextDoc.DTE.Find

   ' Insert ten lines of text.
   For iCtr = 1 To 10
      objEditPt.Insert("This is a test." & Chr(13))
   Next iCtr

   ' Set the find options.
   objFind.Action = vsFindAction.vsFindActionReplaceAll
   objFind.Backwards = False
   objFind.FilesOfType = "*.txt"
   objFind.FindWhat = "test"
   objFind.KeepModifiedDocumentsOpen = True
   objFind.MatchCase = False
   objFind.MatchInHiddenText = False
   objFind.MatchWholeWord = True
   objFind.PatternSyntax = vsFindPatternSyntax.vsFindPatternSyntaxLiteral
   objFind.ReplaceWith = "NEW THING"
   objFind.ResultsLocation = vsFindResultsLocation.vsFindResultsNone
   objFind.SearchPath = "c:\temp"
   objFind.SearchSubfolders = False
   objFind.Target = vsFindTarget.vsFindTargetCurrentDocument
   ' Perform the Find operation.
   objFind.Execute()
End Sub

Siehe auch

Referenz

EnvDTE80-Namespace