Find.FindReplace 方法

依據方法的引數執行尋找 (Find) 或取代 (Replacement) 作業，而不影響針對 Find 設定的選項。

命名空間：  EnvDTE
組件：  EnvDTE (在 EnvDTE.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

.NET Framework 安全性

• 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。

請參閱

參考

Find 介面

EnvDTE 命名空間