Globals - интерфейс

Статья
11/05/2008

Обновлен: Ноябрь 2007

Объект Globals представляет собой кэш для хранения данных во время каждого сеанса работы среды Visual Studio, а также между сеансами с помощью свойства VariablePersists.

Пространство имен: EnvDTE
Сборка: EnvDTE (в EnvDTE.dll)

Синтаксис

'Декларация
<GuidAttribute("E68A3E0E-B435-4DDE-86B7-F5ADEFC19DF2")> _
Public Interface Globals
'Применение
Dim instance As Globals

[GuidAttribute("E68A3E0E-B435-4DDE-86B7-F5ADEFC19DF2")]
public interface Globals

[GuidAttribute(L"E68A3E0E-B435-4DDE-86B7-F5ADEFC19DF2")]
public interface class Globals

public interface Globals

Заметки

Объект Globals позволяет, например, использовать в программах глобальные переменные, значения которых сохраняются от одной процедуры выполнения к другой. Этот объект позволяет также устанавливать для команды значение по умолчанию, если при каждом ее выполнении пользователь должен вводить определенные данные. Кроме того, его можно использовать для изменения поведения команды после того, как она вызвана определенное число раз.

Данные хранятся в объекте Globals в виде пар "имя/значение variant". Эти пары "имя/значение" можно при необходимости записывать на диск с помощью свойства VariablePersists, чтобы сохранять состояние между сеансами среды Visual Studio (в виде строки).

Примечание.
Переменные, содержащие объекты или массивы SafeArrays, не могут быть сохранены. Если значение допускает сохранение в виде строки, оно сохраняется в своем исходном формате.

Надстройки или макросы также могут использовать объект Globals для сохранения пользовательских данных, которые должны оставаться уникальными для определившего их пользователя на протяжении различных сеансов Visual Studio. С помощью объекта Globals можно также сохранять данные в файле решения (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 Globalsglobals = 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.");
}

См. также

Ссылки

Globals - члены

EnvDTE - пространство имен

Другие ресурсы

Сохранение сведений в проектах и решениях

Поделиться через