Globals.VariablePersists – vlastnost

Článek
08/11/2011

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.

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

Syntaxe

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

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é zachovat.

Hodnota vlastnosti

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

Poznámky

Ačkoli globální proměnné vždy přetrvávají v rámci relace z Visual Studio, VariablePersists umožňuje tyto proměnné přetrvávají mezi relací.

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í budou označeny jako 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ého ú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živatelských možností Visual Studio prostředí.

Pokud je globální proměnné přidružen Solution objektu, pak hodnota je uložena v roztoku (SLN). Hodnoty jsou uloženy při každém zápisu souboru SLN prostředí.

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.