Using the Managed Package Framework to Implement a Project Type (C#)
The Managed Package Framework (MPF) provides C# classes you can use or inherit from to implement your own project types. The MPF implements many of the interfaces Visual Studio expects a project type to provide, leaving you free to concentrate on implementing the particulars of your project type.
Using the MPF Project Source Code
The Managed Package Framework for Projects (MPFProj) provides helper classes for creating and managing new project system. Unlike other classes in the MPF, the project classes are not included in the assemblies shipped with Visual Studio. Instead, the project classes are provided as source code at MPF for Projects - VisualStudio.
To add this project to your VSPackage solution, do the following:
Download the MPFProj files to MPFProjectDir.
In the MPFProjectDir\Dev10\Src\CSharp\ProjectBase.file, change the following block:
<!-- Provide a default value for $(ProjectBasePath) -->
<PropertyGroup>
<ProjectBasePath >MPFProjDir\Dev10\Src\CSharp</ProjectBasePath>
</PropertyGroup>
Create a VSPackage project.
Unload the VSPackage project.
Edit the VSPackage .csproj file by adding the following block before the other <Import> blocks:
<Import Project="MPFProjectDir\Dev10\Src\CSharp\ProjectBase.files" />
<PropertyGroup>
<!--To specify a different registry root to register your package, uncomment the TargetRegistryRoot tag and specify a registry root in it.
<TargetRegistryRoot></TargetRegistryRoot>-->
<RegisterOutputPackage>true</RegisterOutputPackage>
<RegisterWithCodebase>true</RegisterWithCodebase>
</PropertyGroup>
Save the project.
Close and reopen the VSPackage solution.
Reopen the VSPackage project. You should see a new directory named ProjectBase.
Add the following reference to the VSPackage project:
Microsoft.Build.Tasks.4.0
Build the project.
Hierarchy Classes
The following table summarizes the classes in the MPFProj that support project hierarchies. For more information, see Hierarchies and Selection.
Class name |
---|
Microsoft.VisualStudio.Package.HierarchyNode |
Microsoft.VisualStudio.Package.ProjectNode |
Microsoft.VisualStudio.Package.ProjectContainerNode |
Microsoft.VisualStudio.Package.FileNode |
Microsoft.VisualStudio.Package.FolderNode |
Microsoft.VisualStudio.Package.ReferenceContainerNode |
Microsoft.VisualStudio.Package.ReferenceNode |
Microsoft.VisualStudio.Package.ProjectReferenceNode |
Microsoft.VisualStudio.Package.ComReferenceNode |
Microsoft.VisualStudio.Package.AssemblyReferenceNode |
Microsoft.VisualStudio.Package.BuildDependency |
Document-Handling Classes
The following table lists the classes in the MPF that support document handling. For more information, see Opening and Saving Project Items.
Class name |
---|
Microsoft.VisualStudio.Package.DocumentManager |
Microsoft.VisualStudio.Package.FileDocumentManager |
Configuration and Output Classes
The following table lists the classes in the MPF that let project types support multiple configurations, such as debug and release, and collections of project output. For more information, see Managing Configuration Options.
Class name |
---|
Microsoft.VisualStudio.Package.ConfigProvider |
Microsoft.VisualStudio.Package.ProjectConfig |
Microsoft.VisualStudio.Package.BuildableProjectConfig |
Microsoft.VisualStudio.Package.OutputGroup |
Microsoft.VisualStudio.Package.ProjectElement |
Automation-Support Classes
The following table lists the classes in the MPF that support automation so that users of your project type can write macros and add-ins.
Class name |
---|
Microsoft.VisualStudio.Package.Automation.OAProject |
Microsoft.VisualStudio.Package.Automation.OANavigableProjectItems |
Microsoft.VisualStudio.Package.Automation.OAProjectItems |
Microsoft.VisualStudio.Package.Automation.OAProjectItem |
Microsoft.VisualStudio.Package.Automation.OANestedProjectItem |
Properties Classes
The following table lists the classes in the MPF that let project types add properties that users can browse and modify in a property browser.
Class name |
---|
Microsoft.VisualStudio.Package.LocalizableProperties |
Microsoft.VisualStudio.Package.NodeProperties |
Microsoft.VisualStudio.Package.FileNodeProperties |
Microsoft.VisualStudio.Package.ProjectNodeProperties |
Microsoft.VisualStudio.Package.FolderNodeProperties |
Microsoft.VisualStudio.Package.ReferenceNodeProperties |