Globals 接口

Globals 对象是一个缓存,它在每个 Visual Studio 环境会话的持续时间内存储数据,并可以使用 VariablePersists 属性在各会话间存储数据。

命名空间:  EnvDTE
程序集:  EnvDTE(在 EnvDTE.dll 中)

语法

声明
<GuidAttribute("E68A3E0E-B435-4DDE-86B7-F5ADEFC19DF2")> _
Public Interface Globals
[GuidAttribute("E68A3E0E-B435-4DDE-86B7-F5ADEFC19DF2")]
public interface Globals
[GuidAttribute(L"E68A3E0E-B435-4DDE-86B7-F5ADEFC19DF2")]
public interface class Globals
[<GuidAttribute("E68A3E0E-B435-4DDE-86B7-F5ADEFC19DF2")>]
type Globals =  interface end
public interface Globals

Globals 类型公开以下成员。

属性

  名称 说明
公共属性 DTE 获取顶级扩展性对象。
公共属性 Parent 获取 Globals 对象的直接父对象。
公共属性 VariableExists 返回指示指定变量是否存在的值。
公共属性 VariableNames 获取所有当前全局变量名的列表。
公共属性 VariablePersists VariablePersists 属性适用于多种类型的 Globals 对象。对于 DTE.Globals 对象,它获取或设置的值指示变量是否由环境保留以及是否在环境的会话之间可用。对于 Solution.Globals 对象,它获取或设置的值指示变量是否由环境保留、是否在环境的各会话之间以及解决方案的加载和卸载之间可用。对于 Project.Globals 对象,它获取或设置的值指示变量是否由环境保留在项目文件中。
公共属性 VariableValue 返回或设置带指定名称的变量。

页首

备注

例如,Globals 对象允许程序具有在执行之间值保持不变的全局变量。它还可以用于允许命令实现默认值,例如如果某个命令每次运行时都要求用户输入信息,就可以使该命令实现默认值。此外,它还可以用于在被调用一定次数后更改自己的行为。

数据以名称/变量值对的形式存储在 Globals 对象中。对于这些名称/值对,可以选择用 VariablePersists 属性将其存储到磁盘上,以便在 Visual Studio 的不同会话间维护它们的状态(作为一个字符串)。

说明说明

无法保存包含对象或 SafeArrays 的变量。如果值可以保存为字符串,则保存时将采用其本机格式。

外接程序或宏还可以使用 Globals 对象在 Visual Studio 会话之间保存每个用户专用的用户定义数据。它们还可以使用 Globals 对象将数据保存为解决方案 (.sln) 文件,也可以使用该对象在解决方案 (.sln) 文件中检索数据。

使用 VariableValue 属性保存或读取使用 Globals 对象存储的值。

说明说明

VariableValue 名称字符串不能包括空格、冒号 (:) 或句点 (.) 字符。如果名称包含任何这些字符,则会收到错误“值不在预期的范围内”。

示例

Sub OnAddinLoaded(ByVal dte As DTE)
    ' Count the number of times an add-in is loaded
    ' and store the value in the solution.
    Dim globals As Globals
    globals = dte.Solution.Globals
    If globals.VariableExists("AddinLoadCounter") Then
        ' The counter has already been set, so increment it.
        Dim int32 As System.Int32
        int32 = System.Int32.Parse(CStr(globals("AddinLoadCounter")))
        int32 += 1
        globals("AddinLoadCounter") = int32.ToString()
    Else
        ' Counter has never been set, so create and initialize it.
        globals("AddinLoadCounter") = 1.ToString()
        globals.VariablePersists("AddinLoadCounter") = True
    End If
    MsgBox("This add-in has been loaded: " & _
    globals.VariableValue("AddinLoadCounter") & " times.")
End Sub
void OnAddinLoaded(_DTE applicationObject)
{
    // Count the number of times an add-in is loaded
    // and store the value in the solution.
    Globals globals;
    globals = applicationObject.Solution.Globals;
    if(globals.get_VariableExists("AddinLoadCounter"))
    {
        // The counter has already been set, so increment it.
        System.Int32 int32;
        int32 = System.Int32.Parse((string)
        globals["AddinLoadCounter"]);
        int32++;
        globals["AddinLoadCounter"] = int32.ToString();
    }
    else
    {
        // Counter has never been set, so create and initialize it.
        globals["AddinLoadCounter"] = 1.ToString();
        globals.set_VariablePersists("AddinLoadCounter", true);
    }
    System.Windows.Forms.MessageBox.Show("This add-in has been loaded: 
    " + globals.VariableValue["AddinLoadCounter"] + " times.");
}

请参见

参考

EnvDTE 命名空间

其他资源

在项目和解决方案中保持信息