Solution4 接口
表示集成开发环境 (IDE) 中所有的项目和解决方案属性。 取代 Solution、Solution2 和 Solution3。
命名空间: EnvDTE100
程序集: EnvDTE100(在 EnvDTE100.dll 中)
语法
声明
<GuidAttribute("CDA7305C-78B6-4D9D-90AD-93EBE71F9341")> _
Public Interface Solution4 _
Inherits Solution3
[GuidAttribute("CDA7305C-78B6-4D9D-90AD-93EBE71F9341")]
public interface Solution4 : Solution3
[GuidAttribute(L"CDA7305C-78B6-4D9D-90AD-93EBE71F9341")]
public interface class Solution4 : Solution3
[<GuidAttribute("CDA7305C-78B6-4D9D-90AD-93EBE71F9341")>]
type Solution4 =
interface
interface Solution3
end
public interface Solution4 extends Solution3
Solution4 类型公开以下成员。
属性
名称 | 说明 | |
---|---|---|
AddIns | 获取 AddIns 集合,它包含与解决方案关联的所有当前可用的外接程序。 | |
Count | 获取一个值,该值指示解决方案中项目的数目。 | |
DTE | 获取顶级扩展性对象。 | |
Extender | 如果请求的扩展程序对象可用于此对象,则获取该扩展程序对象。 | |
ExtenderCATID | 获取对象的扩展程序类别 ID (CATID)。 | |
ExtenderNames | 获取对象的可用扩展程序的列表。 | |
FileName | 基础结构。 获取文件名。 | |
FullName | 获取对象文件的完整路径和名称。 | |
Globals | 获取 Globals 对象,该对象包含可以保存在解决方案 (.sln) 文件、项目文件或用户的配置文件数据中的任何变量值。 | |
IsDirty | 基础结构。 确定解决方案是否已更新(已修改但未保存)。 | |
IsOpen | 获取一个表示解决方案是否打开的值。 | |
Parent | 获取 Solution2 对象的直接父对象。 | |
Projects | 获取解决方案中当前项目的集合。 | |
Properties | 获取属于 Solution2 对象的所有属性的集合。 | |
Saved | 获取或设置一个值,该值指示解决方案自上次保存或打开以来是否未经过修改。 | |
SolutionBuild | 获取解决方案的 SolutionBuild 对象,该对象表示位于解决方案级的生成自动化模型的根。 | |
TemplatePath | 已被 GetProjectTemplate 取代。 |
页首
方法
名称 | 说明 | |
---|---|---|
AddFromFile | 向基于已存储在系统中的项目文件的解决方案添加一个项目。 | |
AddFromTemplate | 将现有项目文件及其包含的任何项或子目录复制到指定位置,并将其添加到解决方案。 | |
AddFromTemplateEx | 将现有项目文件及其包含的任何项或子目录复制到指定位置,并将其添加到解决方案。 | |
AddSolutionFolder | 将解决方案文件夹添加到 ProjectItems 集合中。 | |
Close | 关闭当前解决方案。 | |
Create | 在指定的目录中创建具有指定名称的空解决方案。 | |
FindProjectItem | 在项目中定位项。 | |
GetEnumerator | 返回集合中项的枚举。 | |
GetProjectItemTemplate | 返回所指示的项目项模板的路径。 | |
GetProjectItemTemplates | 返回指定项目的项目项模板的集合。 | |
GetProjectTemplate | 返回指定项目模板的路径。如果模板具有一个 RequiredFrameworkVersion 元素大于 4.0,则应该提供在调用的版本,以使搜索模板将找到匹配。例如,而不是调用 GetProjectTemplate("Extensibility\\1033\\VSIXProject.zip", "CSharp");调用 GetProjectTemplate("Extensibility\\1033\\VSIXProject.zip|FrameworkVersion=4.5", "CSharp");。 | |
Item | 返回 Projects 集合的一个索引成员。 | |
Open | 打开指定的解决方案。 | |
ProjectItemsTemplatePath | 已被 GetProjectItemTemplate 取代。 | |
Remove | 从解决方案中移除指定的项目。 | |
SaveAs | 保存解决方案。 |
页首
备注
Solution4 对象是 IDE 当前实例中所有的项目和所有解决方案属性(如生成配置)的集合。 Solution4 对象对于每个项目都包含一个对应的项目元素,不管该项目是打包项目、子项目,还是顶级项目。
使用 DTE.Solution 引用此对象。 若要引用虚项目(如 MiscFile 或 SolutionItem),请使用 Solution4.Item(EnvDTE.Constants.vsProjectKindMisc) 或 Solution4.Item(EnvDTE.Constants.vsProjectKindSolutionItems)。
示例
有关如何运行此外接程序代码的信息,请参见如何:编译和运行自动化对象模型代码示例。
Public Sub OnConnection(ByVal application As Object, _
ByVal connectMode As ext_ConnectMode, ByVal addInInst As Object, _
ByRef custom As Array) Implements IDTExtensibility2.OnConnection
_applicationObject = CType(application, DTE2)
_addInInstance = CType(addInInst, AddIn)
Solution4Example(_applicationObject)
End Sub
Sub Solution4Example(ByVal dte As DTE2)
' This function creates a solution and adds a Visual C# Console
' project to it.
Try
Dim soln As Solution4 = CType(DTE.Solution, Solution4)
Dim csTemplatePath As String
' This path must exist on your computer.
' Replace <file path> below with an actual path.
Dim csPrjPath As String = "<file path>"
MsgBox("starting")
' Get the project template path for a C# console project.
csTemplatePath = CType(soln.GetProjectTemplate _
("ConsoleApplication.zip", "CSharp"), string)
' Create a new C# Console project using the template obtained
' above.
soln.AddFromTemplate(csTemplatePath, csPrjPath, _
"New CSharp Console Project", False)
MsgBox("done")
Catch ex As System.Exception
MsgBox(ex.ToString)
End Try
End Sub
using System.Windows.Forms;
public void OnConnection(object application,
Extensibility.ext_ConnectMode connectMode, object addInInst,
ref System.Array custom)
{
_applicationObject = (DTE2)application;
_addInInstance = (AddIn)addInInst;
// Pass the applicationObject member variable to the code example.
Solution4Example((DTE2)_applicationObject);
}
public void Solution4Example(DTE2 dte)
{
// This function creates a solution and adds a Visual C# Console
// project to it.
try{
Solution4 soln = (Solution4)_applicationObject.Solution;
String csTemplatePath;
// The file path must exist on your computer.
// Replace <file path> below with an actual path.
String csPrjPath = "<file path>";
"<file path>MessageBox.Show("Starting...");
"<file path>"<file path>csTemplatePath =
soln.GetProjectTemplate("ConsoleApplication.zip", "CSharp");
// Create a new C# Console project using the template obtained
// above.
soln.AddFromTemplate(csTemplatePath, csPrjPath,
"New CSharp Console Project", false);
MessageBox.Show("Done!");
}
catch(SystemException ex)
{
MessageBox.Show("ERROR: " + ex);
}
}