Klasa Package

Artykuł
10/27/2012

Zawiera zarządzane wdrożenia interfejsów, wymagane do utworzenia w pełni funkcjonalny VSPackage.

Hierarchia dziedziczenia

System.Object
Microsoft.VisualStudio.Shell.Package
Microsoft.VisualStudio.Shell.ExtensionPointPackage

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

Składnia

'Deklaracja
<ComVisibleAttribute(True)> _
<PackageRegistrationAttribute> _
Public MustInherit Class Package _
    Implements IVsPackage, IServiceProvider, IOleCommandTarget, IVsPersistSolutionOpts,  _
    IServiceContainer, IServiceProvider, IVsUserSettings, IVsUserSettingsMigration, IVsUserSettingsQuery,  _
    IVsToolWindowFactory, IVsToolboxItemProvider

[ComVisibleAttribute(true)]
[PackageRegistrationAttribute]
public abstract class Package : IVsPackage, 
    IServiceProvider, IOleCommandTarget, IVsPersistSolutionOpts, IServiceContainer, IServiceProvider, 
    IVsUserSettings, IVsUserSettingsMigration, IVsUserSettingsQuery, IVsToolWindowFactory, IVsToolboxItemProvider

Typ Package uwidacznia następujące elementy członkowskie.

Konstruktorzy

	Nazwa	Opis
	Package	Inicjuje nowe wystąpienie Package.

Początek

Właściwości

	Nazwa	Opis
	ApplicationRegistryRoot	Pobiera klucza rejestru głównego bieżącego Visual Studio gałęzi rejestru.
	UserDataPath	Pobiera ścieżkę do przechowywania danych użytkownika dla Visual Studio.
	UserLocalDataPath	Pobiera ścieżkę do przechowywania danych użytkownika lokalnego dla Visual Studio.
	UserRegistryRoot	Pobiera klucz rejestru, który może służyć do przechowywania danych użytkownika.
	Zombied	Pobiera wartość określającą czy pakiet w procesie zamykania.

Początek

Metody

	Nazwa	Opis
	AddOptionKey	Dodaje nazwę klucza opcji użytkownika do listy klawiszy opcji.
	CreateInstance	Tworzy określony using obiektu COM Visual Studiow lokalnym rejestrze identyfikatora CLSID obiektu.
	CreateTool	Umożliwia pochodna klasy do zapewnienia implementacji, jeśli to konieczne.
	CreateToolWindow	Tworzy okno Narzędzie określonego typu o określonym identyfikatorze.
	Dispose	Zwalnia zasoby używane przez Package obiektu.
	Equals	Określa, czy określony obiekt jest równa bieżącego obiektu. (Odziedziczone z Object).
	Finalize	Umożliwia obiekt spróbuj zwolnić zasoby i wykonywania innych operacji oczyszczania, zanim jest odzyskane w procesie wyrzucania elementów bezużytecznych. (Odziedziczone z Object).
	FindToolWindow	Pobiera okno narzędzie odpowiadające określonego typu i identyfikator.
	FindWindowPane	Pobiera okienko odpowiadających określonego typu i identyfikator i jeśli istnieje nie okienko tego typu tworzy jeden Jeśli nakazane.
	GetAutomationObject	Pobiera obiekt automatyzacji dla VSPackage.
	GetDialogPage	Pobiera stronę żądanego okna dialogowego.
	GetGlobalService	Pobiera usługi globalnie przez proffered Visual Studio lub jednego z jego opakowania. Jest taka sama, jak wywoływanie GetService() na wystąpienie pakiet, który sam proffers żadnych usług.
	GetHashCode	Służy jako funkcja mieszania dla określonego typu. (Odziedziczone z Object).
	GetOutputPane	Pobiera okno output żądana.
	GetProviderLocale	Zwraca ustawienia regionalne, skojarzonych z tym usługodawca.
	GetService	Pobiera typ usługi z kontenera usługi VSPackage.
	GetToolboxItemData	Pobiera zawartość identyfikator elementu przybornika określony format danych i format danych.
	GetType	Pobiera Type bieżącej instancji. (Odziedziczone z Object).
	Initialize	Wywoływane, gdy VSPackage jest ładowany przez Visual Studio.
	MemberwiseClone	Tworzy kopię płytkie bieżące Object. (Odziedziczone z Object).
	OnLoadOptions	Wywoływane przez klasę pakietu, gdy dostępne są opcje do odczytu z pliku rozwiązania.
	OnSaveOptions	Wywołany przez Package klasy, gdy dostępne są opcje do zapisania pliku rozwiązania.
	ParseToolboxResource(TextReader, Guid)	Analizuje tekst osadzonego zasobu odpowiedni format, aby uzyskać informacje o tym, które elementy powinny zostać dodane do Przybornik.
	ParseToolboxResource(TextReader, ResourceManager)	Analizuje tekst osadzonego zasobu odpowiedni format, aby uzyskać informacje o tym, które elementy powinny zostać dodane do Przybornik.
	QueryClose	O nazwie poprosić pakiet powłoki może być zamknięty.
	RegisterEditorFactory	Rejestrów przetwórni edytor z Visual Studio.
	RegisterProjectFactory	Rejestrów przetwórni projektu z programu Visual Studio.
	ShowOptionPage	Zostanie wyświetlona strona Opcje do określonych narzędzi.
	ToString	Zwraca ciąg, który reprezentuje bieżącego obiektu. (Odziedziczone z Object).

Początek

Zdarzenia

	Nazwa	Opis
	ToolboxInitialized	Zdarzenia generowane w każdym przypadku, gdy Visual Studio inicjuje jego Przybornik.
	ToolboxUpgraded	Zdarzenia generowane w każdym przypadku, gdy Visual Studio uaktualnienia jego Przybornik.

Początek

Jawne implementacje interfejsu

	Nazwa	Opis
	IServiceContainer.AddService(Type, ServiceCreatorCallback)	Infrastruktura. Dodaje danej usługi do kontenera usługi VSPackage.
	IServiceContainer.AddService(Type, Object)	Infrastruktura. Dodaje danej usługi do kontenera usługi VSPackage.
	IServiceContainer.AddService(Type, ServiceCreatorCallback, Boolean)	Dodaje do kontenera usługi danej usługi, poprzez zastosowanie określonego ServiceCreatorCallback.
	IServiceContainer.AddService(Type, Object, Boolean)	Infrastruktura. Dodaje danej usługi do kontenera usługi VSPackage.
	IServiceProvider.GetService	Pobiera usługi określonego typu.
	IServiceContainer.RemoveService(Type)	Infrastruktura. Usuwa typ danej usługi z kontenera usług.
	IServiceContainer.RemoveService(Type, Boolean)	Infrastruktura. Usuwa typ usługi w danym kontenerze usługi i opcjonalnie promuje usunięcie usługi do kontenerów usługi nadrzędnej.
	IOleCommandTarget.Exec	Wykonuje określone polecenie lub wyświetla Pomoc dla polecenia.
	IOleCommandTarget.QueryStatus	Kwerendy obiekt stanu generowany przez zdarzenia interfejsu użytkownika w jedno lub kilka poleceń.
	IServiceProvider.QueryService	Infrastruktura. Wewnętrzny IServiceProvider wdrożenia.
	IVsPackage.Close	Infrastruktura. Zamyka i usuwa pakiet.
	IVsPackage.GetAutomationObject	Infrastruktura. Pobiera obiekt automatyzacji przyjazne dla tego pakietu.
	IVsPackage.GetPropertyPage	Infrastruktura. Dostęp do proffers Narzędzia menu Opcje i stron właściwości Customize Toolbox okien dialogowych.
	IVsPackage.QueryClose	Infrastruktura. O nazwie poprosić VSPackage Jeśli Visual Studio powłoki może być zamknięty.
	IVsPackage.ResetDefaults	Infrastruktura. Resetuje Przybornik ustawienia domyślne.
	IVsPackage.SetSite	Infrastruktura. Inicjuje VSPackage w Visual Studio środowiska.
	IVsPersistSolutionOpts.LoadUserOptions	Infrastruktura. Ładuje opcje użytkownika dla danego rozwiązania.
	IVsPersistSolutionOpts.ReadUserOptions	Infrastruktura. Odczytuje opcje użytkownika dla danego rozwiązania.
	IVsPersistSolutionOpts.SaveUserOptions	Infrastruktura. Zapisuje opcje użytkownika dla danego rozwiązania.
	IVsPersistSolutionOpts.WriteUserOptions	Infrastruktura. Zapisuje opcje użytkownika dla danego rozwiązania.
	IVsToolboxItemProvider.GetItemContent	Pobiera element.
	IVsToolWindowFactory.CreateToolWindow	Infrastruktura. Tworzy okno Narzędzie określonego typu o określonym identyfikatorze.
	IVsUserSettings.ExportSettings	Ta metoda implementuje IVsUserSettings interfejsu używane do zarządzania profilami i import/eksport ustawień do plików XML.
	IVsUserSettings.ImportSettings	Pobiera konfigurację VSPackage przy użyciu mechanizmu ustawienia programu Visual Studio, gdy użytkownik wybierze opcję importu z Ustawienia importu i eksportu funkcja menu narzędzia IDE.Ta metoda jest częścią realizacji IVsUserSettings interfejs służący do zarządzania profilami i import/eksport ustawień do plików XML.
	IVsUserSettingsMigration.MigrateSettings	Migruje ustawienia z poprzedniej wersji.
	IVsUserSettingsQuery.NeedExport

Początek

Uwagi

Package Klasy zawiera zarządzane wdrożenia kilka interfejsów VSIP najbardziej przydatne.Można utworzyć podstawowe funkcje VSPackage o stosunkowo niewielkiej ilości kodu przez wynikających z Package klasy, przesłanianie niektórych jej metod i dołączając rejestracji atrybut klasy.Package Klasy nie zapewnia obsługi bezpośredniej rejestracji, ale atrybut klasy mogą być używane do dostarczania informacji rejestracji konieczne do zewnętrznych narzędzi, takich jak RegPkg.exe.

Package Klasy oferuje następujące usługi domyślnie.(Można je zastąpić zadając VSPackage dla IServiceContainer, ich usuwania i dodawania własnych usług w ich miejsce.)

Package

Oferuje pakiet jako usługa.
IServiceContainer

Zapewnia możliwość dodawania i usuwania usług.Każda usługa dodaje się "wspierania" ustawiona na true jest proffered do programu Visual Studio, poprzez IProfferService.Dzięki temu usługi globalne na wszystkich VSPackages w programie Visual Studio.(Ta usługa jest dostępna tylko wtedy, gdy VSPackage został już załadowany).

W uzupełnieniu do tych usług Package używa architektury usług programu Visual Studio, w celu zapewnienia dostępu do żadnej usługi, które są dostępne za pośrednictwem globalnego usługodawca.

Bezpieczeństwo wątku

Wszystkie publiczne static (Shared w języku Visual Basic) elementy członkowskie tego typu są bezpieczne dla wątków. Wystąpienia elementów członkowskich nie dają gwarancji bezpieczeństwa wątków.