Globals – rozhraní

Globals Je objekt mezipaměti pro ukládání dat, dobu trvání jednotlivých zasedání 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	Bezprostřední nadřízený objekt dostane 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á zachovány prostředím a je k dispozici mezi zasedáními prostředí.Pro Solution.Globals objektu získá nebo nastaví, zda proměnná zachovány prostředím a je k dispozici mezi relací prostředí a mezi nakládky a vykládky řešení.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.

Na začátek

Poznámky

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

Data jsou uložena v Globals objektu jako dvojice název, varianta hodnota. Tyto dvojice názvu a hodnoty lze volitelně uložit na disk pomocí VariablePersists Vlastnost udržovat jejich státu (jako řetězec) jinou relací mezi Visual Studio.

Poznámka

Proměnné obsahující 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 také použít Globals objekt uložit data definovaná uživatelem jedinečné pro každého 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(.) znaků. 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é

Odkaz

EnvDTE – obor názvů

Další zdroje

Persisting Information in Projects and Solutions