Find2.FindReplace 方法 (vsFindAction, String, Int32, String, vsFindTarget, String, String, vsFindResultsLocation)

發行項
10/28/2012

依據方法的引數執行尋找或取代作業，而不影響 Find 物件設定的選項。

命名空間： EnvDTE80
組件： EnvDTE80 (在 EnvDTE80.dll 中)

語法

'宣告
Function FindReplace ( _
    Action As vsFindAction, _
    FindWhat As String, _
    vsFindOptionsValue As Integer, _
    ReplaceWith As String, _
    Target As vsFindTarget, _
    SearchPath As String, _
    FilesOfType As String, _
    ResultsLocation As vsFindResultsLocation _
) As vsFindResult

vsFindResult FindReplace(
    vsFindAction Action,
    string FindWhat,
    int vsFindOptionsValue,
    string ReplaceWith,
    vsFindTarget Target,
    string SearchPath,
    string FilesOfType,
    vsFindResultsLocation ResultsLocation
)

vsFindResult FindReplace(
    [InAttribute] vsFindAction Action, 
    [InAttribute] String^ FindWhat, 
    [InAttribute] int vsFindOptionsValue, 
    [InAttribute] String^ ReplaceWith, 
    [InAttribute] vsFindTarget Target, 
    [InAttribute] String^ SearchPath, 
    [InAttribute] String^ FilesOfType, 
    [InAttribute] vsFindResultsLocation ResultsLocation
)

abstract FindReplace : 
        Action:vsFindAction * 
        FindWhat:string * 
        vsFindOptionsValue:int * 
        ReplaceWith:string * 
        Target:vsFindTarget * 
        SearchPath:string * 
        FilesOfType:string * 
        ResultsLocation:vsFindResultsLocation -> vsFindResult

function FindReplace(
    Action : vsFindAction, 
    FindWhat : String, 
    vsFindOptionsValue : int, 
    ReplaceWith : String, 
    Target : vsFindTarget, 
    SearchPath : String, 
    FilesOfType : String, 
    ResultsLocation : vsFindResultsLocation
) : vsFindResult

參數

Action
型別：EnvDTE.vsFindAction
必要項。vsFindAction 常數，表示要採取的搜尋動作。

FindWhat
型別：System.String
選擇項。要搜尋的模式比對。預設值為 ""。

vsFindOptionsValue
型別：System.Int32
選擇項。用來表示要進行之搜尋的幾種方式的位元欄位。
關於比對方式，您可以提供 vsFindOptionsMatchCase、vsFindOptionsMatchWholeWord 或 vsFindOptionsMatchInHiddenText。
可以對檔案、專案及方案目標開啟的旗標是 vsFindOptionsSearchSubfolders 和 vsFindOptionsKeepModifiedDocumentsOpen。
FindWhat 屬性語法的旗標是 vsFindOptionsRegularExpression 和 vsFindOptionsWildcards。如果兩者都沒有提供，則 FindWhat 是逐字相符的。
vsFindOptionsValue 預設為關閉所有旗標。

ReplaceWith
型別：System.String
選擇項。當 Action 設定為 vsFindActionReplace 或 vsFindActionReplaceAll 時，要用於取代相符之文字的字串。預設值為 ""。

Target
型別：EnvDTE.vsFindTarget
選擇項。vsFindTarget 常數，表示搜尋作業的目標，例如目前的文件或在檔案中尋找。

SearchPath
型別：System.String
選擇項。要搜尋的目錄和檔名清單 (以分號分隔)。預設值為 ""。

FilesOfType
型別：System.String
選擇項。要包括在搜尋中以分號分隔的檔案類型清單。在指定目標上碰到的其他檔案類型都會被忽略。預設值為 ""，表示所有檔案都要搜尋。

ResultsLocation
型別：EnvDTE.vsFindResultsLocation
選擇項。vsFindResultsLocation 常數。有兩種可以顯示 Find 結果的可能結果清單。您可以執行兩次搜尋而不覆寫掉第一次搜尋的結果。使用 ResultsLocation，您可決定在其中置入 Find 結果的結果清單。

傳回值

型別：EnvDTE.vsFindResult
vsFindResult 常數。

範例

Sub FindReplaceExample()
   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
   objEditPt.StartOfDocument()
   objFind.FindReplace(vsFindAction.vsFindActionReplaceAll, "test", vsFindOptions.vsFindOptionsMatchWholeWord, "NEW THING", vsFindTarget.vsFindTargetOpenDocuments, , , vsFindResultsLocation.vsFindResultsNone)
End Sub