ITextSearchService2.FindForReplace Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Sucht nach dem nächsten Vorkommen des Suchmusters und gibt das Ergebnis des Ersetzens des Suchmusters durch das Ersetzungs Muster zurück.
Überlädt
| FindForReplace(SnapshotPoint, String, String, FindOptions, String) |
Sucht nach dem nächsten Vorkommen von |
| FindForReplace(SnapshotSpan, String, String, FindOptions, String) |
Sucht nach dem nächsten Vorkommen von |
Hinweise
Diese Methode führt keine tatsächlichen Änderungen aus. Consumer müssen einen erstellen ITextEdit , um die tatsächliche Text Ersetzung auszuführen. Diese Methode kann auf jeden beliebigen Thread sicher ausgeführt werden.
FindForReplace(SnapshotPoint, String, String, FindOptions, String)
Sucht nach dem nächsten Vorkommen von searchPattern und legt expandedReplacePattern auf das Ergebnis der Text Ersetzung fest.
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)
Parameter
- startingPosition
- SnapshotPoint
Die Position, ab der die Suche gestartet wird. Die Suche wird auf dem ausgeführt ITextSnapshot , zu dem dieser Parameter gehört.
- searchPattern
- String
in Das Textmuster, nach dem gesucht werden soll.
- replacePattern
- String
Das Muster, mit dem der gefundene Text ersetzt werden soll.
- options
- FindOptions
Optionen, die zum Durchführen der Suche verwendet werden.
- expandedReplacePattern
- String
Das Ergebnis der Ersetzung. Dieser Ausgabeparameter ist beim Durchführen von regulären Ausdrucks Suchvorgängen hilfreich. Ist leer, wenn keine Übereinstimmungen gefunden werden.
Gibt zurück
Ein SnapshotSpan , der auf das gefundene Suchergebnis zeigt. Wenn keine Übereinstimmungen gefunden werden, wird NULL zurückgegeben.
Hinweise
Diese Funktion führt keine Änderungen aus. Die Consumer müssen einen erstellen ITextEdit , um die tatsächliche Text Ersetzung auszuführen, wenn gewünscht. Diese Methode kann von jedem Thread sicher ausgeführt werden.
Beachten Sie, dass expandedReplacePattern immer gleich replacePattern ist, wenn bei der Suche keine regulären Ausdrücke verwendet werden. In diesen Szenarien können Sie das einfachere verwenden Find(SnapshotSpan, SnapshotPoint, String, FindOptions) .
Gilt für
FindForReplace(SnapshotSpan, String, String, FindOptions, String)
Sucht nach dem nächsten Vorkommen von searchPattern und legt expandedReplacePattern auf das Ergebnis der Text Ersetzung fest.
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)
Parameter
- searchRange
- SnapshotSpan
Der Textbereich, in dem gesucht werden soll.
- searchPattern
- String
in Das Textmuster, nach dem gesucht werden soll.
- replacePattern
- String
Das Muster, mit dem der gefundene Text ersetzt werden soll.
- options
- FindOptions
Optionen, die zum Durchführen der Suche verwendet werden.
- expandedReplacePattern
- String
Das Ergebnis der Ersetzung. Dieser Ausgabeparameter ist beim Durchführen von regulären Ausdrucks Suchvorgängen hilfreich. Ist leer, wenn keine Übereinstimmungen gefunden werden.
Gibt zurück
Ein SnapshotSpan , der auf das gefundene Suchergebnis zeigt. Wenn keine Übereinstimmungen gefunden werden, wird NULL zurückgegeben.
Hinweise
Diese Funktion führt keine Änderungen aus. Die Consumer müssen einen erstellen ITextEdit , um die tatsächliche Text Ersetzung auszuführen, wenn gewünscht. Diese Methode kann von jedem Thread sicher ausgeführt werden.
Beachten Sie, dass expandedReplacePattern immer gleich replacePattern ist, wenn für die Suche keine regulären Ausdrücke verwendet werden. In diesen Szenarien können Sie das einfachere verwenden Find(SnapshotSpan, SnapshotPoint, String, FindOptions) .