Powiązane usługi i interfejsy (pakiet VSPackage kontroli kodu źródłowego)
W tej sekcji wymieniono wszystkie interfejsy związane z pakietem VSPackage kontroli źródła w zestawie Visual Studio SDK. Pakiet VSPackage kontroli źródła implementuje niektóre z tych interfejsów i używa innych do wykonywania zadań kontroli źródła.
Interfejsy implementowane przez pakiety VSPackage kontroli kodu źródłowego i
Poniższe interfejsy są opisane w zestawie VISUAL Studio SDK, a pakiet VSPackage kontroli źródła implementuje ich podzbiór w zależności od żądanego zestawu funkcji. Niektóre interfejsy są oznaczone jako wymagane i muszą być implementowane przez każdy pakiet VSPackage kontroli źródła.
W przypadku tych interfejsów, których pakiet nie implementuje, program Visual Studio zapewnia domyślną implementację. Należy pamiętać, że domyślna implementacja jest przeznaczona dla przypadku, gdy pakiet VSPackage nie jest zarejestrowany i żaden projekt nie jest kontrolowany. Poprawnie napisana kontrola źródła vsPackage implementuje wszystkie niezbędne interfejsy, a nie pozostawiając go do domyślnej implementacji tych interfejsów.
Pakiet VSPackage kontroli źródła musi zaimplementować usługę prywatną, która hermetyzuje niektóre lub wszystkie poniższe interfejsy.
Interfejsy to:
Wymagane: odpowiednia jednostka (pakiet VSPackage kontroli źródła, stub kontroli kodu źródłowego, projekt) musi zaimplementować interfejs.
Zalecane: jednostka powinna zaimplementować ten interfejs; w przeciwnym razie funkcjonalność kontroli źródła może być ograniczona.
Opcjonalnie: jednostka może zaimplementować ten interfejs, aby zapewnić bogatszy zestaw funkcji.
| Interfejs | Purpose | Zaimplementowane przez | Zaimplementować? |
|---|---|---|---|
| IVsQueryEditQuerySave2 | Edytory nazywają ten interfejs przed zmodyfikowaniem lub zapisaniem pliku. Pakiet VSPackage kontroli źródła może wyewidencjonować plik lub odrzucić operację, jeśli wyewidencjonowanie zakończy się niepowodzeniem. | Pakiet VSPackage kontroli źródła | Zalecane |
| IVsSccManager2 | Ten interfejs zapewnia podstawowe funkcje kontroli źródła dla projektów, takich jak rejestrowanie i wyrejestrowywanie projektów za pomocą kontroli źródła i zapewnianie obsługi podstawowych glyphs kontroli źródła. | Pakiet VSPackage kontroli źródła | Wymagania |
| IVsSccProject2 | Ten interfejs jest uzyskiwany z IVsHierarchy funkcji przy użyciu QueryInterface funkcji lub po prostu rzutując obiekt implementowany IVsHierarchy na IVsSccProject2. Służy do pobierania plików pod kontrolą źródła w projekcie lub do informowania projektu o bieżącym stanie kontroli źródła lub lokalizacji. |
Projekt | Wymagania |
| IVsSccProvider | Moduł integracji używa tego interfejsu do ustawiania bieżącego aktywnego pakietu VSPackage. | Pakiet VSPackage kontroli źródła | Wymagania |
| IVsTrackProjectDocuments2 | Ten interfejs jest oparty na modelu subskrypcji. Każdy pakiet VSPackage może sygnalizować, że chce odbierać zdarzenia dokumentu i być zalecane przez powłokę na zdarzeniach, które mają się zdarzyć. Jest on implementowany i obsługiwany przez program Visual Studio, który z kolei przekazuje zdarzenia implementowane IVsTrackProjectDocumentsEvents2 do pakietu VSPackage. |
Źródło kontroli źródła wycinków | Wymagania |
| IVsTrackProjectDocuments3 | Ten interfejs zapewnia przetwarzanie wsadowe, synchronizowane operacje odczytu/zapisu i zaawansowaną OnQueryAddFiles metodę. |
Źródło kontroli źródła wycinków | Wymagania |
| IVsTrackProjectDocumentsEvents2 | Eksplorator rozwiązań i projekty wywołają ten interfejs, gdy nowe pliki są dodawane do projektów lub gdy pliki i foldery są zmieniane lub usuwane z projektów. Pakiet VSPackage kontroli źródła może wyewidencjonować plik projektu lub anulować operację. | Pakiet VSPackage kontroli źródła | Zalecane |
| IVsTrackProjectDocumentsEvents3 | Eksplorator rozwiązań i projekty wywołają ten interfejs w odpowiedzi na wywołania wykonywane do metod interfejsu IVstrackProjectDocuments3. Pakiet VSPackage kontroli źródła może śledzić operacje wsadowe, synchronizowane operacje odczytu/zapisu i pracować z bardziej zaawansowaną OnQueryAddFiles metodą. |
Pakiet VSPackage kontroli źródła | Zalecane |
| IVsSccEnlistmentPathTranslation | Ten interfejs zapewnia obsługę zarządzania rejestracją dla projektów sieci Web. | Pakiet VSPackage kontroli źródła | Zalecane |
| IVsSccManagerTooltip | Ten interfejs służy do pobierania narzędzia Wskazówki dla plików kontrolowanych przez źródło w projektach. | Pakiet VSPackage kontroli źródła | Opcjonalnie |
| IVsSccOpenFromSourceControl | Ten interfejs zapewnia obsługę rozszerzenia przestrzeni nazw. | Pakiet VSPackage kontroli źródła | Opcjonalnie |
| IVsSccControlNewSolution | Pakiet VSPackage używa tego interfejsu do integracji rozszerzenia przestrzeni nazw z oknami dialogowym Nowe, Otwarte lub Zapisz . W związku z tym projekty można automatycznie dodawać do kontroli źródła podczas tworzenia lub do kontroli źródła, gdy operacja zapisywania jest w toku. | Pakiet VSPackage kontroli źródła | Opcjonalnie |
| IVsSccGlyphs | Pakiet VSPackage używa tego interfejsu do definiowania dodatkowych glyphs jako glyphs kontroli źródła dla węzłów w Eksplorator rozwiązań. | Pakiet VSPackage kontroli źródła | Opcjonalnie |
| IVsSccAddWebProjectFromSourceControl | Okno dialogowe Dodawanie projektów sieci Web używa tego interfejsu. Udostępnia metody przeglądania lokalizacji kontroli źródła i otwierania projektu sieci Web dodanego wcześniej w repozytorium kontroli źródła w tej lokalizacji. | Pakiet VSPackage kontroli źródła | Zalecane |
| IVsAsynchOpenFromScc | Ten interfejs zapewnia obsługę asynchronicznego (w tle) ładowania projektów z kontroli źródła. | Pakiet VSPackage kontroli źródła | Opcjonalnie |
| IVsAsynchOpenFromSccProjectEvents | Ten interfejs umożliwia projektom obserwowanie postępu asynchronicznego ładowania zainicjowanego przez IVsAsynchOpenFromSccprogram . | Projekt | Opcjonalnie |
| IVsSccToolsOptions | Ten interfejs umożliwia środowisku IDE wykonywanie zapytań dotyczących aktywnego pakietu VSPackage kontroli źródła. Środowisko IDE wysyła zapytanie o wartość ustawień kontroli źródła, które mają znaczenie nawet wtedy, gdy nie zarejestrowano aktywnego pakietu VSPackage kontroli źródła. Ten interfejs jest implementowany i obsługiwany przez program Visual Studio. | Źródło kontroli źródła wycinków | Wymagania |
| IVsRegisterScciProvider | Ten interfejs jest używany do rejestrowania pakietu VSPackage kontroli źródła. | Źródło kontroli źródła wycinków | Wymagania |
| SourceControl | Ten interfejs jest używany w automatyzacji. W związku z tym uwidacznia tylko funkcje, które można wykonać bez wyświetlania żadnego interfejsu użytkownika. | Pakiet VSPackage kontroli źródła | Opcjonalnie |
| IVsPersistSolutionProps | Ten interfejs służy do zapisywania ustawień kontroli źródła w pliku rozwiązania (sln). Ustawienia obejmują lokalizację kontroli źródła i flagi stanu kontroli źródła. | Pakiet VSPackage kontroli źródła | Zalecane |
| IVsPersistSolutionOpts | Ten interfejs służy do zapisywania ustawień kontroli źródła w pliku opcji rozwiązania (suo). Może to obejmować ustawienia kontroli źródła specyficzne dla użytkownika, takie jak lokalizacja rejestracji bieżącego użytkownika. | Pakiet VSPackage kontroli źródła | Zalecane |
| IVsSolutionEvents3 | Ten interfejs służy do monitorowania zdarzeń w celu wykonywania operacji, takich jak ewidencjonowanie plików projektu przed zamknięciem rozwiązań lub pobieranie nowych plików z kontroli źródła podczas otwierania projektu. | Pakiet VSPackage kontroli źródła | Zalecane |