Interfejs Globals

Globals Obiekt jest buforu do przechowywania danych na czas trwania każdej sesji Visual Studio środowiska, jak również w sesjach, za pomocą VariablePersists właściwości.

Przestrzeń nazw:  EnvDTE
Zestaw:  EnvDTE (w EnvDTE.dll)

Składnia

'Deklaracja
<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

Typ Globals uwidacznia następujące elementy członkowskie.

Właściwości

	Nazwa	Opis
	DTE	Pobiera obiekt rozszerzalności najwyższego poziomu.
	Parent	Zwraca obiekt nadrzędny natychmiastowe z Globals obiektu.
	VariableExists	Zwraca się, czy istnieje w określonej zmiennej.
	VariableNames	Pobiera listę wszystkie aktualne nazwy zmiennej globalnej.
	VariablePersists	VariablePersists Właściwość stosuje się do kilku typów Globals obiektów.Dla DTE.Globals obiekt pobiera lub ustawia, czy zmienna jest zachowywana przez środowisko naturalne i jest dostępny między sesjami środowiska.Dla Solution.Globals obiekt pobiera lub ustawia, czy zmienna jest zachowywana przez środowisko naturalne i jest dostępny, między sesjami środowiska naturalnego oraz między załadunku i rozładunku roztworu.Dla Project.Globals obiekt pobiera lub ustawia, czy zmienna jest zachowywana przez środowiska w pliku projektu.
	VariableValue	Zwraca lub ustawia zmienną o określonej nazwie.

Początek

Uwagi

Globals Obiektu, na przykład pozwala programom mają zmienne globalne, których wartości utrzymują się między egzekucji.Może również służyć za umożliwia polecenie do wykonania wartość domyślną, jeśli wymaga ona użytkownikowi wprowadzić informacje o każdym razem, gdy jest wykonywana.Ponadto może służyć do zmiany jego zachowania, po przeprowadzeniu wywoływane liczbę razy.

Dane są przechowywane w Globals obiektu jako pary wariant nazwa wartość.Te pary nazwa/wartość Opcjonalnie może być przechowywana na dysku za pomocą VariablePersists właściwość, aby utrzymać ich stan (jako ciąg) między sesjami różnych Visual Studio.

[!UWAGA]

Zmienne zawierające obiekty lub SafeArrays nie może być zapisany.Jeśli wartość mogą być zapisywane jako ciąg, następnie jest zapisywany w jego oryginalnym formacie.

Dodatki lub makra można także użyć Globals obiektu do zapisania danych zdefiniowane przez użytkownika unikatowy dla każdego użytkownika między Visual Studio sesji.Mogą również wykorzystać Globals obiekt, aby zapisać dane i pobierać dane z pliku roztworu (.sln).

Użyj VariableValue właściwości do zapisu lub odczytu wartości zapisane z Globals obiektu.

[!UWAGA]

VariableValueciągi nazwa nie może zawierać przestrzeń, dwukropek (:) lub znaki period(.).Jeśli nazwa zawiera żadnego z tych znaków, komunikat o błędzie, "Wartość nie wchodzą w zakres oczekiwanego".

Przykłady

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.");
}

Zobacz też

Informacje

Przestrzeń nazw EnvDTE

Inne zasoby

Przechowywanie informacji w projektach i rozwiązaniach