Generic vs. Language-Specific Project Models
Visual Studio provides two types of project models: a generic one and programming language-specific ones.
Generic Project Model
The generic project model is represented by the following types:
Object Name |
Description |
|---|---|
Projects collection |
Represents all projects in the solution. |
Project object |
Represents a project in the solution. |
ProjectItems collection |
Represents all of the items in a specified project. |
ProjectItem object |
Represents an item in a specified project. |
These objects allow you to manipulate projects of any language type in Visual Studio. Using them, you can:
Save or delete a project.
Create a new project item for a project, based on the Visual Studio templates.
Add project items to a project from existing files.
Remove project items from a project.
Open, save, and delete project items from a project.
Language-Specific Project Model
In addition to the generic project-related objects, a set of namespaces represents the programming language-specific project and project item properties. These namespaces are:
The main objects that represents language projects is VSProject and VSProject2. VSProject2 derives from VSProject, which in turn derives from Project. Project items are represented by VSProjectItem objects.
Programming Language |
Namespaces |
|---|---|
Visual C# |
VSLangProj, VSLangProj2, and VSLangProj80. |
Visual Basic |
VSLangProj, VSLangProj2, and VSLangProj80. |
Visual J# |
VSLangProj, VSLangProj2, and VSLangProj80. |
Visual C++ |
Microsoft.VisualStudio.VCProject and Microsoft.VisualStudio.VCProjectEngine. |
All programming languages |
Since the language-specific objects derive from the generic ones, they work essentially the same, except that they give you access to any additional properties, methods, and events that cannot be accessed with the generic Project and ProjectItem objects.
For more information about how to use the language-specific project model, see Introduction to Project Extensibility.
Change for Visual Studio.NET 2003 Visual C++ Projects
In Visual Studio.NET 2003 and beyond, special handling for the ProjectItems collection for Visual C++ is no longer required. That is, while the Visual C++ Projects collection previously stored all Visual C++ project files in a flat list, now the files are stored hierarchically as they are in the other programming languages.
Since this change can affect your existing code, there is a way to emulate the old behavior in the new project-specific object model when trying to index the ProjectItems collection to determine whether or not a file is in the project. The primary difference is that you can now return to the DTE object model by calling .Object on a Visual C++ object.
[Visual Basic]
Dim proj as VCProject = DTE.ActiveSolutionProjects(1).Object
Dim fileColl as IVCCollection = proj.Files
Dim file as VCFile = fileColl.Item("MyFile.cpp")
Dim projItem as ProjectItem = file.Object
See Also
Tasks
How to: Programmatically Create Projects
How to: Programmatically Create Project Items