Globals.VariablePersists – vlastnost

Článek
10/27/2012

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.

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

Syntaxe

'Deklarace
Property VariablePersists ( _
    VariableName As String _
) As Boolean

bool this[
    string VariableName
] { get; set; }

property bool VariablePersists[String^ VariableName] {
    bool get (String^ VariableName);
    void set (String^ VariableName, bool value);
}

abstract VariablePersists : bool with get, set

Jazyk JScript nepodporuje indexované vlastnosti.

Parametry

VariableName
Typ: System.String
Povinné.Představuje název proměnné, které chcete zachovat.

Hodnota vlastnosti

Typ: System.Boolean
Logická hodnota označující, zda proměnná existuje. VariablePersists Vrátí true Pokud existuje proměnná, jinak vrátí false.

Poznámky

Přestože globální proměnné vždy přetrvávají v rámci relace z Visual Studio, VariablePersists umožňuje tyto proměnné se mezi jednotlivými relacemi zachováno.

[!POZNÁMKA]

Proměnné s konkrétní řešení pomocí DTE.Solution.Globals.

Pokud proměnná neexistuje, VariablePersists vrátí false.

Pro Solution objektu (Solution.Globals), uložení dat při každém uložení řešení.Změna Globals objekt způsobuje soubor řešení stanou označeno upravit (nebo "dirty").Pro DTE objektu (DTE.Globals), buď při uložení dat Visual Studio prostředí vypnut nebo při uložení řešení.V obou případech jsou data uložena v souboru řešení (.sln) nebo v strukturované úložiště souborů v adresáři uživatelských profilů.

Při vypnutí prostředí nebo Save All dojde, jsou uloženy všechny globální hodnoty.Pokud VariablePersists spojena DTE objektu, hodnota je uložena v adresáři uživatele možnosti Visual Studio prostředí.

Pokud je globální proměnné přidružen Solution objektu, pak hodnota je uložena v souboru řešení (.sln).Hodnoty jsou uloženy v každém prostředí zapíše soubor .sln.

Všechny uložené proměnné přepsání dříve uložené hodnoty.Chcete-li odstranit proměnnou z uloženého souboru, nastavte VariablePersists na false.Prostředí odeberete jeho hodnotu během Save operace.

[!POZNÁMKA]

VariableValueNázvy nesmí obsahovat mezery.Pokud, se zobrazí chybová zpráva, 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.");
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.