Metodo Find.FindReplace

Articolo
08/11/2011

Effettua un'operazione di ricerca o sostituzione basata sugli argomenti del metodo senza modificare le opzioni impostate per l'oggetto Find.

Spazio dei nomi: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)

Sintassi

'Dichiarazione
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

Parametri

Action
Tipo: EnvDTE.vsFindAction
Obbligatorio.Costante vsFindAction che indica l'azione di ricerca da effettuare.

FindWhat
Tipo: System.String
Facoltativo.Il testo da cercare.Il valore predefinito è "".

vsFindOptionsValue
Tipo: System.Int32
Facoltativo.Un campo di bit indicante vari aspetti della ricerca da effettuare.
Per la corrispondenza, è possibile fornire vsFindOptionsMatchCase, vsFindOptionsMatchWholeWord o vsFindOptionsMatchInHiddenText.
I flag che possono essere attivati per file, progetto e soluzione di destinazione sono vsFindOptionsSearchSubfolders e vsFindOptionsKeepModifiedDocumentsOpen.
I flag per la sintassi della proprietà FindWhat sono vsFindOptionsRegularExpression e vsFindOptionsWildcards.Se non viene fornito alcun flag, verrà eseguita una ricerca letterale di FindWhat.
vsFindOptionsValue disattiva tutti i flag in base all'impostazione predefinita.

ReplaceWith
Tipo: System.String
Facoltativo.Stringa con cui sostituire il testo di ricerca quando Action è impostato su vsFindActionReplace o vsFindActionReplaceAll.Il valore predefinito è "".

Target
Tipo: EnvDTE.vsFindTarget
Facoltativo.Costante vsFindTarget che indica la destinazione dell'operazione di ricerca, ad esempio il documento corrente oppure i file.

SearchPath
Tipo: System.String
Facoltativo.Un elenco di directory e nomi file separati da punto e virgola in cui eseguire la ricerca.Il valore predefinito è "".

FilesOfType
Tipo: System.String
Facoltativo.Un elenco di tipi di file separati da punto e virgola da includere nella ricerca.Gli altri tipi di file presenti nella destinazione specificata per la ricerca verranno ignorati.Il valore predefinito è "" e significa che la ricerca viene effettuata in tutti i file.

ResultsLocation
Tipo: EnvDTE.vsFindResultsLocation
Facoltativo.Costante vsFindResultsLocation.Esistono due elenchi in cui i risultati di un'operazione Find possono essere visualizzati.Questo consente di effettuare due ricerche senza sovrascrivere i risultati della prima ricerca.Mediante ResultsLocation è possibile stabilire in quale inserire i risultati Find.

Valore restituito

Tipo: EnvDTE.vsFindResult
Costante vsFindResult.

Esempi

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

Find Interfaccia

Spazio dei nomi EnvDTE

Condividi tramite