Interfejs IVsTrackProjectDocuments3

 

Ten interfejs umożliwia dla przetwarzania wsadowego, koordynacji blokad plików i zaawansowanym OnQueryAddFiles metody.

Przestrzeń nazw:   Microsoft.VisualStudio.Shell.Interop
Zestaw:  Microsoft.VisualStudio.Shell.Interop.8.0 (w Microsoft.VisualStudio.Shell.Interop.8.0.dll)

Składnia

[GuidAttribute("53544C4D-9097-4325-9270-754EB85A6351")]
[InterfaceTypeAttribute(1)]
public interface IVsTrackProjectDocuments3

[GuidAttribute("53544C4D-9097-4325-9270-754EB85A6351")]
[InterfaceTypeAttribute(1)]
public interface class IVsTrackProjectDocuments3

[<GuidAttribute("53544C4D-9097-4325-9270-754EB85A6351")>]
[<InterfaceTypeAttribute(1)>]
type IVsTrackProjectDocuments3 = interface end

<GuidAttribute("53544C4D-9097-4325-9270-754EB85A6351")>
<InterfaceTypeAttribute(1)>
Public Interface IVsTrackProjectDocuments3

Metody

	Nazwa	Opis
	BeginQueryBatch()	Uruchamia proces kwerendy partii, w którym przedstawiono zamiast wielu oknach dialogowych, po jednym dla każdego pliku jednego okna dialogowego monitowania użytkownika o OK.
	CancelQueryBatch()	Anuluje wsadowej serii kwerend.
	EndQueryBatch(Int32)	Wskazuje, że proces kwerendy wsadowej zostało wypełnione i określa, czy operacji wsadowej powinny móc kontynuować.
	HandsOffFiles(UInt32, Int32, String[])	Ta metoda jest wywoływane, gdy projekt chce wpłynąć na liczbę plików i chce, aby wszystkie blokady z tymi plikami wydany.
	HandsOnFiles(Int32, String[])	Wskazuje, że projekt jest wykonywane manipulowania określone pliki.
	OnQueryAddFilesEx(IVsProject, Int32, String[], String[], VSQUERYADDFILEFLAGS[], VSQUERYADDFILERESULTS[], VSQUERYADDFILERESULTS[])	Ta metoda jest rozszerzoną wersją OnQueryAddFiles metody i jest używany, gdy projekt będzie przeniesienie plików do nowej lokalizacji w katalogu projektu.

Uwagi

Zaawansowane wersji OnQueryAddFiles metoda obsługuje projektów, które skopiować pliki do nowej lokalizacji w katalogu projektu po ekstrakcji z kontrolą źródła.

Musi być zrównoważone metody procesu wsadowego; Każde wywołanie do BeginQueryBatch metoda musi być dopasowane z wywołanie do EndQueryBatch metody lub CancelQueryBatch metody.Metody procesu wsadowego są używane tak, że użytkownik jest przedstawiane z jednego okna dialogowego dotyczące operacji na wszystkie pliki, zamiast wielu okien dialogowych, jeden dla każdego pliku.Jeśli dowolny typ kwerendy, mówi nie szkodzi kontynuować operację, CancelQueryBatch powinna zostać wywołana, aby anulować operację całej partii.Inaczej, jeśli wszystkie kwerendy wskazują, nic nie szkodzi kontynuować, EndQueryBatch można wywołać metody.Na przykład:

BOOL fRenameCanCont = FALSE;
pTrackProjectDocuments3->BeginQueryBatch();
QueryFolderRename(pFolderNode, strOldPath, strNewPath, &fRenameCanCont);
if (fRenameCanCont)
   pTrackProjectDocuments3->EndQueryBatch(&fRenameCanCont);
else
   pTrackProjectDocuments3->CancelQueryBatch();

bool fRenameCanCont = false;
pTrackProjectDocuments3.BeginQueryBatch();
QueryFolderRename(pFolderNode, strOldPath, strNewPath, fRenameCanCont);
if (fRenameCanCont)
   pTrackProjectDocuments3.EndQueryBatch(&fRenameCanCont);
else
   pTrackProjectDocuments3.CancelQueryBatch();

W tym przykładzie QueryFolderRename zakłada się funkcja helper zdefiniowane przez użytkownika, która powoduje serii powtarzalnie wywołują zdarzenia, że OnQueryRenameFile metody.

Uwagi dotyczące implementacji:

Ten interfejs jest implementowana przez pakiet sterowania źródłowy programu Visual Studio.Visual Studio przekierowuje wywołania do tego interfejsu pakietu kontroli źródła aktualnie aktywne, jeśli dany pakiet implementuje IVsTrackProjectDocumentsEvents3 interfejsu.

[!UWAGA]

Ten interfejs nie jest pochodną IVsTrackProjectDocuments2 interfejsu, chociaż zazwyczaj jest zaimplementowana w tym samym obiekcie.IVsTrackProjectDocuments3 Interfejsu można uzyskać dzięki sformułowaniu pytań takich go z SVsTrackProjectDocuments usługi.

Uwagi dotyczące wywoływania:

Ten interfejs zapewnia, że mechanizm przetwarzania wsadowego, który zezwala na wiele dostępów do systemu kontroli źródła bez konieczności posiadania monit dla każdego pliku.Ponadto ten interfejs synchronizuje dostęp do odczytu i zapisu do plików i zapewnia rozszerzenie OnQueryAddFiles metody.

Zobacz też

Przestrzeń nazw Microsoft.VisualStudio.Shell.Interop

Powrót do początku