Globals – rozhraní

Globals Je objekt mezipaměti pro ukládání dat, dobu trvání každé relace Visual Studio životního prostředí jako přes relací pomocí VariablePersists vlastnost.

Obor názvů:  EnvDTE
Sestavení:  EnvDTE (v EnvDTE.dll)

Syntaxe

'Deklarace
<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 zveřejňuje následující členy.

Vlastnosti

	Název	Popis
	DTE	Načtení objektu nejvyšší úrovně rozšiřitelnosti.
	Parent	Získá bezprostřední nadřízený objekt Globals objektu.
	VariableExists	Vrátí se, zda existuje zadané proměnné.
	VariableNames	Získá seznam všech aktuální globální proměnné názvů.
	VariablePersists	VariablePersists Vlastnost se vztahuje na několik typů Globals objektů.Pro DTE.Globals objektu získá, nebo nastaví, zda proměnná je zachována prostředím a je k dispozici mezi relacemi prostředí.Pro Solution.Globals objektu získá, nebo nastaví, zda proměnná je zachována prostředím a mezi relacemi prostředí a mezi nakládky a vykládky řešení je k dispozici.Pro Project.Globals objektu získá, nebo nastaví, zda je zachována proměnné prostředí v souboru projektu.
	VariableValue	Vrátí nebo nastaví proměnnou se zadaným názvem.

Nahoru

Poznámky

Globals Objektu, například umožňuje mít globální proměnné, jejichž hodnoty přetrvávají mezi spouštění programů.To lze také povolit příkaz implementovat výchozí hodnotu, pokud vyžaduje uživatele k zadání informací pokaždé, když ji spustí.Kromě toho lze použít ke změně chování poté, co byl vyvolán počet opakování.

Data jsou uložena v Globals objektu jako dvojice varianty/název hodnota.Tyto dvojice názvu a hodnoty lze volitelně uložit na disk pomocí VariablePersists vlastnost udržovat jejich stavu (jako řetězec) mezi různými zasedání Visual Studio.

[!POZNÁMKA]

Proměnné, které obsahují objekty nebo SafeArrays nelze uložit.Pokud hodnota lze uložit jako řetězec, uloží se v nativním formátu.

Doplňky nebo makra můžete použít také Globals objekt uložit data definovaná uživatelem jedinečný uživatele mezi Visual Studio relací.Můžete také použít Globals objektu data uložit a načíst data ze souboru řešení (.sln).

Použití VariableValue vlastnost uložit nebo načíst hodnoty uložené se Globals objektu.

[!POZNÁMKA]

VariableValueřetězce název nesmí obsahovat mezery, dvojtečku (:) nebo period(.) znaky.Pokud název obsahuje některý z těchto znaků, zobrazí chybová zpráva, že "Hodnota nespadá do očekávaného rozsahu."

Příklady

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

Viz také

Referenční dokumentace

EnvDTE – obor názvů

Další zdroje

Uchovávání informací v projektech a řešeních