Proprietà Globals.VariablePersists

Articolo
10/30/2012

VariablePersists la proprietà si applica a diversi tipi di Globals oggetti.per DTE.Globals oggetto, ottiene o imposta se la variabile viene mantenuta dall'ambiente ed è disponibile tra le sessioni dell'ambiente.per Solution.Globals oggetto, ottenere o impostare se la variabile viene mantenuta dall'ambiente ed è disponibile tra le sessioni dell'ambiente e tra caricamento e scaricamento di una soluzione.per Project.Globals oggetto, ottenere o impostare se la variabile viene mantenuta dall'ambiente nel file di progetto.

Spazio dei nomi: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)

Sintassi

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

JScript non supporta le proprietà indicizzate.

Parametri

VariableName
Tipo: System.String
obbligatorio.Rappresenta il nome della variabile per mantenere.

Valore proprietà

Tipo: System.Boolean
Un valore booleano che indica se una variabile. VariablePersists restituisce true se una variabile esiste, in caso contrario false.

Note

Sebbene le variabili globali persista sempre all'interno di una sessione di Visual Studio, VariablePersists consente di queste variabili persista tra le sessioni.

[!NOTA]

Per salvare variabili con una soluzione particolare, utilizzare DTE.Solution.Globals.

se la variabile non esiste, VariablePersists restituisce false.

per Solution oggetto (Solution.Globals), i dati vengono salvati quando la soluzione viene salvata.modificare Globals l'oggetto determina il file di soluzione a diventare contrassegnato come modificato (o “modifica„).per DTE oggetto (DTE.Globals), i dati vengono salvati generalmente quando Visual Studio l'ambiente viene arrestato o quando una soluzione viene salvata.In entrambi i casi, i dati vengono archiviati nel file di soluzione (sln) o nel file strutturato di archiviazione nella directory dei profili utente.

Quando l'ambiente viene arrestato o a Save All si verifica, tutti i valori globali vengono salvati.se VariablePersists è associato DTE oggetto, il valore viene salvato nella directory delle opzioni utente del Visual Studio ambiente.

Se la variabile globale è associata Solution oggetto, il valore verrà salvato nel file di soluzione (sln).I valori vengono salvati ogni volta che l'ambiente scrive il file sln.

Tutte le variabili salvate sovrascrivono i valori precedentemente salvato.Per rimuovere una variabile dal file salvato, set VariablePersists in false.L'ambiente rimuove il valore durante il successivo Save operazione.

[!NOTA]

VariableValue i nomi non possono contenere spazi.In caso affermativo, viene generato l'errore, valore non fa parte dell'intervallo previsto.

Esempi

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.