Package Class (Microsoft.VisualStudio.Shell)

MSDN Library
Development Tools and Languages
Visual Studio 2008
Visual Studio
Visual Studio SDK
Visual Studio SDK Reference
Microsoft.VisualStudio.Shell Namespace

Package Class

Package Members
Package Constructor
Package Methods
Package Properties
Package Events

Related Links

Package Class
This page is specific to:.NET Framework Version:2.03.54.0

Visual Studio SDK

Package Class

Updated: November 2007

Provides a managed implementation of the VSIP interfaces required to create a fully functional VSPackage.

This API is not CLS-compliant.

Namespace: Microsoft.VisualStudio.Shell
Assembly: Microsoft.VisualStudio.Shell.9.0 (in Microsoft.VisualStudio.Shell.9.0.dll)

Syntax

C++

JScript

Copy to Clipboard Print

'Usage

Dim instance As Package

'Declaration

<CLSCompliantAttribute(False)> _
<PackageRegistrationAttribute> _
<ComVisibleAttribute(True)> _
Public MustInherit Class Package _
    Implements IVsPackage, IServiceProvider, IOleCommandTarget, IVsPersistSolutionOpts,  _
    IServiceContainer, IServiceProvider, IVsUserSettings, IVsToolWindowFactory

Remarks

The Package class provides a managed implementation of several of the most useful VSIP interfaces. The implementation is compatible with the .NET Framework. A VSIP developer can create the basic functionality of a VSPackage with relatively little code by deriving from the Package class, overriding some of its methods, and attaching registration attribute classes. The Package class does not provide direct registration support, but it can use attribute classes to supply the necessary registration information to external tools such as RegPkg.exe.

The Package class offers the following services by default. (You can replace them by asking the VSPackage for IServiceContainer, removing them, and adding your own services in their place.)

Package
The package offers itself as a service.
IServiceContainer
Provides the ability to add and remove services. Any service added with "promote" set to true is proffered to Visual Studio through IProfferService. This makes the service global to all VSPackages within Visual Studio. (The VSIP Extras version of IServiceContainer does not support global services, so this service is only available if the VSPackage has already been loaded.)

In addition to these services, Package uses the service architecture of Visual Studio to provide access to any service available through the global service provider, including the entire Visual Studio SDK set of services.

Inheritance Hierarchy

System..::.Object
Microsoft.VisualStudio.Shell..::.Package

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Reference

Package Members

Microsoft.VisualStudio.Shell Namespace

IVsPackage

Other Resources

Managed VSPackages

VSPackages and the Managed Package Framework

Registering VSPackages (C#)