Package Класс

Ссылка

Определение

Пространство имен:: Microsoft.VisualStudio.Shell

Сборка:: Microsoft.VisualStudio.Shell.14.0.dll

Сборка:: Microsoft.VisualStudio.Shell.15.0.dll

Сборка:

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Предоставляет управляемую реализацию интерфейсов, необходимых для создания полностью функционального пакета VSPackage.

public ref class Package abstract : IServiceProvider, Microsoft::VisualStudio::OLE::Interop::IOleCommandTarget, Microsoft::VisualStudio::OLE::Interop::IServiceProvider, Microsoft::VisualStudio::Shell::Interop::IVsPackage, Microsoft::VisualStudio::Shell::Interop::IVsPersistSolutionOpts, Microsoft::VisualStudio::Shell::Interop::IVsToolboxItemProvider, Microsoft::VisualStudio::Shell::Interop::IVsToolWindowFactory, Microsoft::VisualStudio::Shell::Interop::IVsUserSettings, Microsoft::VisualStudio::Shell::Interop::IVsUserSettingsMigration, Microsoft::VisualStudio::Shell::Interop::IVsUserSettingsQuery, System::ComponentModel::Design::IServiceContainer

public ref class Package abstract : IServiceProvider, Microsoft::VisualStudio::OLE::Interop::IOleCommandTarget, Microsoft::VisualStudio::OLE::Interop::IServiceProvider, Microsoft::VisualStudio::Shell::Interop::IVsPackage, Microsoft::VisualStudio::Shell::Interop::IVsPersistSolutionOpts, Microsoft::VisualStudio::Shell::Interop::IVsToolboxItemProvider, Microsoft::VisualStudio::Shell::Interop::IVsToolboxItemProvider2, Microsoft::VisualStudio::Shell::Interop::IVsToolWindowFactory, Microsoft::VisualStudio::Shell::Interop::IVsUserSettings, Microsoft::VisualStudio::Shell::Interop::IVsUserSettingsMigration, Microsoft::VisualStudio::Shell::Interop::IVsUserSettingsQuery, System::ComponentModel::Design::IServiceContainer

[Microsoft.VisualStudio.Shell.PackageRegistration]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Package : IServiceProvider, Microsoft.VisualStudio.OLE.Interop.IOleCommandTarget, Microsoft.VisualStudio.OLE.Interop.IServiceProvider, Microsoft.VisualStudio.Shell.Interop.IVsPackage, Microsoft.VisualStudio.Shell.Interop.IVsPersistSolutionOpts, Microsoft.VisualStudio.Shell.Interop.IVsToolboxItemProvider, Microsoft.VisualStudio.Shell.Interop.IVsToolWindowFactory, Microsoft.VisualStudio.Shell.Interop.IVsUserSettings, Microsoft.VisualStudio.Shell.Interop.IVsUserSettingsMigration, Microsoft.VisualStudio.Shell.Interop.IVsUserSettingsQuery, System.ComponentModel.Design.IServiceContainer

[Microsoft.VisualStudio.Shell.PackageRegistration]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Package : IServiceProvider, Microsoft.VisualStudio.OLE.Interop.IOleCommandTarget, Microsoft.VisualStudio.OLE.Interop.IServiceProvider, Microsoft.VisualStudio.Shell.Interop.IVsPackage, Microsoft.VisualStudio.Shell.Interop.IVsPersistSolutionOpts, Microsoft.VisualStudio.Shell.Interop.IVsToolboxItemProvider, Microsoft.VisualStudio.Shell.Interop.IVsToolboxItemProvider2, Microsoft.VisualStudio.Shell.Interop.IVsToolWindowFactory, Microsoft.VisualStudio.Shell.Interop.IVsUserSettings, Microsoft.VisualStudio.Shell.Interop.IVsUserSettingsMigration, Microsoft.VisualStudio.Shell.Interop.IVsUserSettingsQuery, System.ComponentModel.Design.IServiceContainer

[<Microsoft.VisualStudio.Shell.PackageRegistration>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Package = class
    interface IVsPackage
    interface IServiceProvider
    interface IOleCommandTarget
    interface IVsPersistSolutionOpts
    interface IServiceContainer
    interface IServiceProvider
    interface IVsUserSettings
    interface IVsUserSettingsMigration
    interface IVsUserSettingsQuery
    interface IVsToolWindowFactory
    interface IVsToolboxItemProvider

[<Microsoft.VisualStudio.Shell.PackageRegistration>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Package = class
    interface IVsPackage
    interface IServiceProvider
    interface IOleCommandTarget
    interface IVsPersistSolutionOpts
    interface IServiceContainer
    interface IServiceProvider
    interface IVsUserSettings
    interface IVsUserSettingsMigration
    interface IVsUserSettingsQuery
    interface IVsToolWindowFactory
    interface IVsToolboxItemProvider
    interface IVsToolboxItemProvider2

Public MustInherit Class Package
Implements IOleCommandTarget, IServiceContainer, IServiceProvider, IServiceProvider, IVsPackage, IVsPersistSolutionOpts, IVsToolboxItemProvider, IVsToolWindowFactory, IVsUserSettings, IVsUserSettingsMigration, IVsUserSettingsQuery

Public MustInherit Class Package
Implements IOleCommandTarget, IServiceContainer, IServiceProvider, IServiceProvider, IVsPackage, IVsPersistSolutionOpts, IVsToolboxItemProvider, IVsToolboxItemProvider2, IVsToolWindowFactory, IVsUserSettings, IVsUserSettingsMigration, IVsUserSettingsQuery

Наследование: Object
Package

Производный: Microsoft.VisualStudio.Modeling.Shell.ModelingPackage

Microsoft.VisualStudio.Shell.AsyncPackage

Microsoft.VisualStudio.Shell.ExtensionPointPackage

Атрибуты: PackageRegistrationAttribute ComVisibleAttribute

Реализации: IOleCommandTarget IServiceProvider IVsPackage IVsPersistSolutionOpts IVsToolboxItemProvider IVsToolWindowFactory IVsUserSettings IVsUserSettingsMigration IVsUserSettingsQuery IServiceContainer IServiceProvider IVsToolboxItemProvider2

PackageКласс предоставляет управляемую реализацию нескольких наиболее полезных интерфейсов VSIP. Вы можете создать базовые функциональные возможности VSPackage с сравнительно небольшим кодом, производя от Package класса, переопределив некоторые его методы и присоединив классы атрибутов регистрации. PackageКласс не поддерживает прямую регистрацию, но может использовать классы атрибутов для предоставления необходимых сведений о регистрации внешним средствам, таким как RegPkg.exe.

По Package умолчанию класс предлагает следующие службы. (Их можно заменить, запросив пакет VSPackage IServiceContainer , удалив их и добавив собственные службы на своем месте.)

Package

Пакет предоставляет себя в качестве службы.
IServiceContainer

Предоставляет возможность добавлять и удалять службы. Любая служба, добавленная с параметром "Promote" true , имеет значение предложенной в Visual Studio с помощью IProfferService . Это делает службу глобальной для всех пакетов VSPackage в Visual Studio. (Эта служба доступна, только если пакет VSPackage уже загружен.)

Помимо этих служб, Package использует архитектуру службы Visual Studio для предоставления доступа к любой службе, доступной через поставщика глобальных служб.

Конструкторы

Package()

Инициализирует новый экземпляр Package.

Свойства

ApplicationRegistryRoot	Возвращает корневой раздел реестра текущего куста реестра Visual Studio.
UserDataPath	Возвращает путь к хранилищу пользовательских данных для Visual Studio.
UserLocalDataPath	Возвращает путь к хранилищу локальных пользовательских данных для Visual Studio.
UserRegistryRoot	Получает раздел реестра, который можно использовать для хранения данных пользователей.
Zombied	Получает значение, указывающее, находится ли пакет в процессе завершения работы.

Методы

AddOptionKey(String)	Добавляет имя ключа параметров пользователя в список ключей параметров.
CreateInstance(Guid, Guid, Type)	Создает указанный COM-объект, используя объект CLSID локального реестра Visual Studio.
CreateTool(Guid)	Позволяет производным классам предоставлять реализацию, если это необходимо.
CreateToolWindow(Guid, Int32)	Создает окно инструментов заданного типа с указанным идентификатором.
CreateToolWindow(Type, Int32)	Создает окно инструментов заданного типа с указанным идентификатором.
CreateToolWindow(Type, Int32, Object)	Создать окно инструментов указанного типа с указанным ИДЕНТИФИКАТОРом.
CreateToolWindow(Type, Int32, UInt32)	Создает окно инструментов заданного типа с указанным идентификатором.
CreateToolWindow(Type, Int32, UInt32, Object, Guid)	Создать окно инструментов указанного типа с указанным ИДЕНТИФИКАТОРом. Это единственный метод, который должен вызывать IVsUiShell. CreateToolWindow ()
Dispose(Boolean)	Освобождает ресурсы, используемые объектом Package.
FindToolWindow(Type, Int32, Boolean)	Получает окно инструментов, соответствующее указанному типу и идентификатору.
FindWindowPane(Type, Int32, Boolean)	Получает панель окна, соответствующую указанному типу и идентификатору, и если панели окна этого типа не существует, создает ее, если поступает такая команда.
GetAutomationObject(String)	Получает объект автоматизации для VSPackage.
GetDialogPage(Type)	Получает запрашиваемую страницу диалогового окна.
GetGlobalService(Type)	Получает службу, предложенной глобально Visual Studio или одним из ее пакетов.Это аналогично вызову метода профферс () на экземпляре пакета, который не сами службы.
GetOutputPane(Guid, String)	Получает зарегистрированное окно вывода.
GetProviderLocale()	Возвращает языковой стандарт, связанный с этим поставщиком служб.
GetService(Type)	Получает службы на основе типа из контейнера служб VSPackage.
GetToolboxItemData(String, DataFormats+Format)	Получает содержимое формата данных для указанного идентификатора элемента панели элементов и формата данных.
GetToolboxItemDataAsync(String, DataFormats+Format)
Initialize()	Вызывается, когда пакет VSPackage загружается Visual Studio.
InstantiateToolWindow(Type)
InstantiateToolWindow(Type, Object)	Создание окна инструментов указанного типа.
IsExperimentalInstance(IServiceProvider)
IsLocalService(Type)	Определяет, можно ли получить указанный тип службы, не требуя перехода RPC в поток пользовательского интерфейса.
OnLoadOptions(String, Stream)	Вызывается классом пакетов при наличии параметров, доступных для считывания из файла решения.
OnSaveOptions(String, Stream)	Вызывается классом Package при наличии параметров, которые необходимо сохранить в файле решения.
ParseToolboxResource(TextReader, Guid)	Выполняет синтаксический анализ внедренного текстового ресурса соответствующего формата для получения сведений о том, какие элементы следует добавить на панель элементов.
ParseToolboxResource(TextReader, ResourceManager)	Выполняет синтаксический анализ внедренного текстового ресурса соответствующего формата для получения сведений о том, какие элементы следует добавить на панель элементов.
QueryClose(Boolean)	Вызывается, чтобы запросить пакет о возможности закрытия оболочки.
RegisterEditorFactory(IVsEditorFactory)	Регистрирует фабрику редактора в Visual Studio.
RegisterProjectFactory(IVsProjectFactory)	Регистрирует фабрику проекта с помощью Visual Studio.
ShowOptionPage(Type)	Отображает указанную страницу настроек инструментов.

События

ToolboxInitialized	Событие, создаваемое всякий раз, когда Visual Studio инициализирует свою панель элементов.
ToolboxUpgraded	Событие, создаваемое всякий раз, когда Visual Studio обновляет свою панель элементов.

Явные реализации интерфейса

IOleCommandTarget.Exec(Guid, UInt32, UInt32, IntPtr, IntPtr)	Выполняет указанную команду или отображает справку для команды.
IOleCommandTarget.QueryStatus(Guid, UInt32, OLECMD[], IntPtr)	Запрашивает объект о состоянии одной или нескольких команд, созданных событиями пользовательского интерфейса.
IServiceContainer.AddService(Type, Object)	Добавляет заданную службу в контейнер служб VSPackage.
IServiceContainer.AddService(Type, Object, Boolean)	Добавляет заданную службу в контейнер служб VSPackage.
IServiceContainer.AddService(Type, ServiceCreatorCallback)	Добавляет заданную службу в контейнер служб VSPackage.
IServiceContainer.AddService(Type, ServiceCreatorCallback, Boolean)	Добавляет заданную службу в контейнер служб с использованием указанного объекта ServiceCreatorCallback.
IServiceContainer.RemoveService(Type)	Удаляет указанный тип службы из контейнера служб.
IServiceContainer.RemoveService(Type, Boolean)	Удаляет данный тип службы из контейнера служб и дополнительно распространяет службу удаление службы в родительские контейнеры служб.
IServiceProvider.GetService(Type)	Получает службу указанного типа.
IServiceProvider.QueryService(Guid, Guid, IntPtr)	Реализация внутренних IServiceProvider.
IVsPackage.Close()	Закрывает и удаляет пакет.
IVsPackage.GetAutomationObject(String, Object)	Получает понятный для автоматизации объект для данного пакета.
IVsPackage.GetPropertyPage(Guid, VSPROPSHEETPAGE[])	Профферс доступ к меню «Сервис» и страницам свойств диалоговых окон «Настройка панели элементов».
IVsPackage.QueryClose(Int32)	Вызывается для запроса VSPackage, если оболочка Visual Studio может быть закрыта.
IVsPackage.ResetDefaults(UInt32)	Сбрасывает значения по умолчанию Панели элементов.
IVsPackage.SetSite(IServiceProvider)	Инициализирует VSPackage в среде Visual Studio.
IVsPersistSolutionOpts.LoadUserOptions(IVsSolutionPersistence, UInt32)	Загружает параметры пользователя для данного решения.
IVsPersistSolutionOpts.ReadUserOptions(IStream, String)	Считывает параметры пользователя для данного решения.
IVsPersistSolutionOpts.SaveUserOptions(IVsSolutionPersistence)	Сохраняет параметры пользователя для данного решения.
IVsPersistSolutionOpts.WriteUserOptions(IStream, String)	Записывает параметры пользователя для данного решения.
IVsToolboxItemProvider.GetItemContent(String, UInt16, IntPtr)	Получает элемент.
IVsToolboxItemProvider2.GetItemContentAsync(String, UInt16)
IVsToolWindowFactory.CreateToolWindow(Guid, UInt32)	Создает окно инструментов заданного типа с указанным идентификатором.
IVsUserSettings.ExportSettings(String, IVsSettingsWriter)	Этот метод реализует интерфейс IVsUserSettings, используемый для управления профилями и импорта/экспорта параметров в XML-файлы.
IVsUserSettings.ImportSettings(String, IVsSettingsReader, UInt32, Int32)	Извлекает конфигурацию VSPackage с помощью механизма параметров Visual Studio, когда пользователь выбирает параметр Импорт параметров импорта и экспорта в меню Сервис интегрированной среды разработки. Этот метод является частью реализации интерфейса IVsUserSettings, используемого для управления профилями и импорта/экспорта параметров в XML-файлы.
IVsUserSettingsMigration.MigrateSettings(IVsSettingsReader, IVsSettingsWriter, String)	Переносит параметры из предыдущей версии.
IVsUserSettingsQuery.NeedExport(String, Int32)	Определяет, изменились ли параметры, и их следует экспортировать заново.

Методы расширения

QueryService(IServiceProvider, Guid)	Возвращает службу, предоставляемую поставщиком услуг на основе ее типа службы.
QueryService<TService>(IServiceProvider)	Возвращает службу, предоставляемую поставщиком услуг на основе ее типа службы.

Применяется к

Package Класс

Определение

Комментарии

Конструкторы

Свойства

Методы

События

Явные реализации интерфейса

Методы расширения

Применяется к

Дополнительные ресурсы

Package Класс

Были ли сведения на этой странице полезными?

Определение

Комментарии

Конструкторы

Свойства

Методы

События

Явные реализации интерфейса

Методы расширения

Применяется к

Дополнительные ресурсы