ITextSearchService2.FindForReplace Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет поиск следующего вхождения шаблона поиска и возвращает результат замены шаблона поиска шаблоном замены.
Перегрузки
| FindForReplace(SnapshotPoint, String, String, FindOptions, String) |
Выполняет поиск следующего вхождения |
| FindForReplace(SnapshotSpan, String, String, FindOptions, String) |
Выполняет поиск следующего вхождения |
Комментарии
Этот метод не выполняет фактические изменения. Потребители должны создать ITextEdit для выполнения фактической замены текста. Этот метод является надежным для выполнения в любом потоке.
FindForReplace(SnapshotPoint, String, String, FindOptions, String)
Выполняет поиск следующего вхождения searchPattern и задает expandedReplacePattern результат замены текста.
public:
Nullable<Microsoft::VisualStudio::Text::SnapshotSpan> FindForReplace(Microsoft::VisualStudio::Text::SnapshotPoint startingPosition, System::String ^ searchPattern, System::String ^ replacePattern, Microsoft::VisualStudio::Text::Operations::FindOptions options, [Runtime::InteropServices::Out] System::String ^ % expandedReplacePattern);
public Microsoft.VisualStudio.Text.SnapshotSpan? FindForReplace (Microsoft.VisualStudio.Text.SnapshotPoint startingPosition, string searchPattern, string replacePattern, Microsoft.VisualStudio.Text.Operations.FindOptions options, out string expandedReplacePattern);
abstract member FindForReplace : Microsoft.VisualStudio.Text.SnapshotPoint * string * string * Microsoft.VisualStudio.Text.Operations.FindOptions * string -> Nullable<Microsoft.VisualStudio.Text.SnapshotSpan>
Public Function FindForReplace (startingPosition As SnapshotPoint, searchPattern As String, replacePattern As String, options As FindOptions, ByRef expandedReplacePattern As String) As Nullable(Of SnapshotSpan)
Параметры
- startingPosition
- SnapshotPoint
Расположение, с которого начинается поиск. Поиск будет выполнен для того, ITextSnapshot к которому принадлежит этот параметр.
- searchPattern
- String
окне Шаблон текста для поиска.
- replacePattern
- String
Шаблон для замены найденного текста.
- options
- FindOptions
Параметры, используемые для выполнения поиска.
- expandedReplacePattern
- String
Результат замены. Этот выходной параметр будет полезен при выполнении поиска регулярных выражений. Будет пустым, если совпадения не найдены.
Возвращаемое значение
Объект, SnapshotSpan указывающий на найденный результат поиска. Если совпадений не найдено, возвращается значение null.
Комментарии
Эта функция не выполняет никаких изменений. Потребители должны были создать объект ITextEdit для выполнения фактической замены текста при необходимости. Этот метод является надежным для выполнения из любого потока.
Обратите внимание, что expandedReplacePattern значение всегда будет равно, replacePattern Если поиск не использует регулярные выражения. В этих сценариях можно использовать более легкие Find(SnapshotSpan, SnapshotPoint, String, FindOptions) .
Применяется к
FindForReplace(SnapshotSpan, String, String, FindOptions, String)
Выполняет поиск следующего вхождения searchPattern и задает expandedReplacePattern результат замены текста.
public:
Nullable<Microsoft::VisualStudio::Text::SnapshotSpan> FindForReplace(Microsoft::VisualStudio::Text::SnapshotSpan searchRange, System::String ^ searchPattern, System::String ^ replacePattern, Microsoft::VisualStudio::Text::Operations::FindOptions options, [Runtime::InteropServices::Out] System::String ^ % expandedReplacePattern);
public Microsoft.VisualStudio.Text.SnapshotSpan? FindForReplace (Microsoft.VisualStudio.Text.SnapshotSpan searchRange, string searchPattern, string replacePattern, Microsoft.VisualStudio.Text.Operations.FindOptions options, out string expandedReplacePattern);
abstract member FindForReplace : Microsoft.VisualStudio.Text.SnapshotSpan * string * string * Microsoft.VisualStudio.Text.Operations.FindOptions * string -> Nullable<Microsoft.VisualStudio.Text.SnapshotSpan>
Public Function FindForReplace (searchRange As SnapshotSpan, searchPattern As String, replacePattern As String, options As FindOptions, ByRef expandedReplacePattern As String) As Nullable(Of SnapshotSpan)
Параметры
- searchRange
- SnapshotSpan
Диапазон текста для поиска.
- searchPattern
- String
окне Шаблон текста для поиска.
- replacePattern
- String
Шаблон для замены найденного текста.
- options
- FindOptions
Параметры, используемые для выполнения поиска.
- expandedReplacePattern
- String
Результат замены. Этот выходной параметр будет полезен при выполнении поиска регулярных выражений. Будет пустым, если совпадения не найдены.
Возвращаемое значение
Объект, SnapshotSpan указывающий на найденный результат поиска. Если совпадений не найдено, возвращается значение null.
Комментарии
Эта функция не выполняет никаких изменений. Потребители должны были создать объект ITextEdit для выполнения фактической замены текста при необходимости. Этот метод является надежным для выполнения из любого потока.
Обратите внимание, что expandedReplacePattern значение всегда будет равно, replacePattern Если поиск не использует регулярные выражения. В этих сценариях можно использовать более легкие Find(SnapshotSpan, SnapshotPoint, String, FindOptions) .