Find.FindReplace - метод
Обновлен: Ноябрь 2007
Выполняет операции поиска или замены с использованием аргументов метода. На параметры 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
'Применение
Dim instance As Find
Dim Action As vsFindAction
Dim FindWhat As String
Dim vsFindOptionsValue As Integer
Dim ReplaceWith As String
Dim Target As vsFindTarget
Dim SearchPath As String
Dim FilesOfType As String
Dim ResultsLocation As vsFindResultsLocation
Dim returnValue As vsFindResult
returnValue = instance(Action, FindWhat, _
vsFindOptionsValue, ReplaceWith, _
Target, SearchPath, FilesOfType, _
ResultsLocation)
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
)
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
Разрешения
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.