Find Arabirim

Başvuru

Tanım

Ad Alanı:: EnvDTE

Bütünleştirilmiş Kod:: EnvDTE.dll

Bütünleştirilmiş Kod:

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

FindBelgeler ve dosyalar için ortamdaki genel metin işlemlerini destekler.

public interface class Find

public interface class Find

__interface Find

[System.Runtime.InteropServices.Guid("40D4B9B6-739B-4965-8D65-692AEC692266")]
[System.Runtime.InteropServices.TypeLibType(4160)]
public interface Find

[<System.Runtime.InteropServices.Guid("40D4B9B6-739B-4965-8D65-692AEC692266")>]
[<System.Runtime.InteropServices.TypeLibType(4160)>]
type Find = interface

Public Interface Find

Türetilmiş: EnvDTE80.Find2

Öznitelikler: GuidAttribute TypeLibTypeAttribute

Örnekler

Sub FindExample()  
   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  

   ' Set the find options.  
   objFind.Action = vsFindAction.vsFindActionReplaceAll  
   objFind.Backwards = False  
   objFind.FilesOfType = "*.txt"  
   objFind.FindWhat = "test"  
   objFind.KeepModifiedDocumentsOpen = True  
   objFind.MatchCase = False  
   objFind.MatchInHiddenText = False  
   objFind.MatchWholeWord = True  
   objFind.PatternSyntax = vsFindPatternSyntax.vsFindPatternSyntaxLiteral  
   objFind.ReplaceWith = "NEW THING"  
   objFind.ResultsLocation = vsFindResultsLocation.vsFindResultsNone  
   objFind.SearchPath = "c:\temp"  
   objFind.SearchSubfolders = False  
   objFind.Target = vsFindTarget.vsFindTargetCurrentDocument  
   ' Perform the Find operation.  
   objFind.Execute()  
End Sub

Açıklamalar

FindNesnesi, kod Düzenleyicisi gibi gibi işlemleri destekleyen ortam konumlarında metin aramanızı ve değiştirmenizi sağlar.

Bu, öncelikli olarak makro kaydetme amacıyla hazırlanmıştır. Düzenleyicinin makro kayıt mekanizması, Find TextSelection.FindPattern genel bulma işlevselliğini bulabilmeniz ve genellikle TextSelection nesne bul gibi işlemler için nesneyi kullanmaktan daha faydalı olduğundan, bunun yerine ' ı kullanır.

Visual Studio ortamında, arama özellikleri sağlayan tüm araçları genelinde paylaşılan küresel bir bulma durumu vardır. Örneğin, tüm Visual Studio öğeler bir oturum sırasında kullanılan arama desenlerinin geçmişini paylaşır ve Find Açık belgeler için bir sonraki işlemin ileri veya geri iletme olması gerekip gerekmediğini belirtir. FindNesnenin özellikleri ile etkileşim kurar ve genel bulma durumunu izler. Nesne üzerinde Özellikler ayarladığınızda Find , genel bulma durumunu da ayarlarsınız. Kullanıcılar Find ortamı aracılığıyla bir işlem gerçekleştirdiyse, Find nesne gerçekleştirdikleri arama türünü yansıtır. Otomasyon kodu ortamın UI iş parçacığı ile eşzamanlı olarak çalıştığından, bazı özelliklerden bazılarını ayarlamanıza ve kullanıcının çağırabilmeniz için önce bir arama gerçekleştirmesini gerekli değildir Execute .

ExecuteYöntemi, Find nesnesinin ayarlarına bağlı olarak bir işlem gerçekleştirir Find . Ayrıca, FindReplace genel bulma durumunu etkilemeden bir arama gerçekleştirmek için bağımsız değişkenleri yöntemine geçirebilirsiniz. Otomasyon istemcilerinin, genel bulma durumunu etkilemeden veya son kullanıcının ortam durumunun modeliyle kesintiye uğramadan arama gerçekleştirebilmeleri önemlidir.

Özellikler

Action	Sonraki eşleşmeyi bul, tümünü bul, Değiştir ve bul gibi nasıl bulunacağını alır veya ayarlar.
Backwards	Aramanın geçerli konumdan geriye doğru gerçekleştirilip gerçekleştirilmediğini gösteren bir değer alır veya ayarlar.
DTE	Üst düzey genişletilebilirlik nesnesini alır.
FilesOfType	Aranacak dosyalar için dosya uzantısını alır veya ayarlar.
FindWhat	Bulunacak metni veya kalıbı alır veya ayarlar.
KeepModifiedDocumentsOpen	`Değiştirme` işleminden sonra değiştirilen belgelerin açık kalıp kalmayacağını gösteren bir değer alır veya ayarlar.
MatchCase	Aramanın büyük/küçük harfe duyarlı olup olmadığını gösteren bir değer alır veya ayarlar.
MatchInHiddenText	Gizli metnin aramaya dahil edilip edilmediğini gösteren bir değer alır veya ayarlar.
MatchWholeWord	Aramanın yalnızca tüm sözcüklerle eşleşip eşleşmediğini gösteren bir değer alır veya ayarlar.
Parent	Bir nesnenin hemen üst nesnesini alır Find .
PatternSyntax	Arama modelini belirtmek için kullanılan söz dizimini alır veya ayarlar.
ReplaceWith	Değiştirme işlemi için değiştirme metnini alır veya ayarlar.
ResultsLocation	Sonuçların toplu arama işleminde gösterildiği konumu alır veya ayarlar.
SearchPath	Dosyaları bul işleminde kullanılacak dizinlerin listesini alır veya ayarlar.
SearchSubfolders	Alt klasörlerin bir `arama` işlemine dahil edilip edilmediğini gösteren bir değer alır veya ayarlar.
Target	Arama işleminin hedefini (tüm açık belgeler, dosyalar, etkin belge vb.) alır veya ayarlar.

Yöntemler

Execute()	Nesnesi için ayarlanan seçeneklere dayanan bir arama gerçekleştirir Find .
FindReplace(vsFindAction, String, Int32, String, vsFindTarget, String, String, vsFindResultsLocation)	İçin ayarlanan seçenekleri etkilemeden, yöntemin bağımsız değişkenlerine dayalı bulma veya değiştirme işlemi gerçekleştirir Find .

Şunlara uygulanır