Globals.VariablePersists[String] Propriété

Définition

La propriété VariablePersists[String] s'applique à plusieurs types d'objets Globals. Pour la DTE. Globals , elle obtient ou définit une valeur indiquant si la variable est conservée par l’environnement et disponible entre les sessions de l’environnement. Pour l’objet solution. Globals , elle obtient ou définit une valeur indiquant si la variable est conservée par l’environnement et disponible entre les sessions de l’environnement et entre le chargement et le déchargement d’une solution. Pour l’objet Project. Globals , elle obtient ou définit une valeur indiquant si la variable est conservée par l’environnement dans le fichier projet.

public:
 property bool VariablePersists[System::String ^] { bool get(System::String ^ VariableName); void set(System::String ^ VariableName, bool value); };
[System.Runtime.InteropServices.DispId(4)]
public bool VariablePersists[string VariableName] { [System.Runtime.InteropServices.DispId(4)] get; [System.Runtime.InteropServices.DispId(4)] set; }
[<System.Runtime.InteropServices.DispId(4)>]
[<get: System.Runtime.InteropServices.DispId(4)>]
[<set: System.Runtime.InteropServices.DispId(4)>]
member this.VariablePersists(string) : bool with get, set
Public Property VariablePersists(VariableName As String) As Boolean

Paramètres

VariableName
String

Obligatoire. Représente le nom de la variable à conserver.

Valeur de propriété

Boolean

Valeur booléenne indiquant si une variable existe ou non. VariablePersists[String] retourne la valeur true si une variable existe ; dans le cas contraire, retourne la valeur false.

Attributs

Exemples

Sub GlobalsExample(ByVal dte As DTE)  
    Dim globals As Globals  
    globals = dte.Solution.Globals  
    If globals.VariableExists("GlobalsExample") Then  
        ' The counter has already been set, so increment it.  
        Dim int32 As System.Int32  
        int32 = System.Int32.Parse(CStr(globals("GlobalsExample")))  
        int32 += 1  
        globals("GlobalsExample") = int32.ToString()  
    Else  
        ' Counter has never been set, so create and initialize it.  
        globals("GlobalsExample") = 1.ToString()  
        globals.VariablePersists("GlobalsExample") = True  
    End If  
    MsgBox("This variable has been called: " & _  
    globals.VariableValue("GlobalsExample") & " times.")  
End Sub  
void GlobalsExample(_DTE applicationObject)  
{  
    Globals globals;  
    globals = applicationObject.Solution.Globals;  
    if(globals.get_VariableExists("GlobalsExample"))  
    {  
        // The counter has already been set, so increment it.  
        System.Int32 int32;  
        int32 = System.Int32.Parse((string)  
        globals["GlobalsExample"]);  
        int32++;  
        globals["GlobalsExample"] = int32.ToString();  
    }  
    else  
    {  
        // Counter has never been set, so create and initialize it.  
        globals["GlobalsExample"] = 1.ToString();  
        globals.set_VariablePersists("GlobalsExample", true);  
    }  
    System.Windows.Forms.MessageBox.Show("This variable has been called:   
    " + globals.VariableValue["GlobalsExample"] + " times.");  
}  

Remarques

Bien que les variables globales persistent toujours au sein d’une session de Visual Studio , VariablePersists[] autorise la conservation de ces variables entre les sessions.

Notes

Pour enregistrer des variables avec une solution particulière, utilisez DTE.Solution.Globals .

Si la variable n’existe pas, VariablePersists[] retourne false .

Pour l' Solution objet ( Solution.Globals ), les données sont enregistrées chaque fois que la solution est enregistrée. GlobalsSi vous modifiez l’objet, le fichier solution est marqué comme modifié (ou « modifié »). Pour l' DTE objet ( DTE.Globals ), les données sont enregistrées lorsque l' Visual Studio environnement est arrêté ou lorsqu’une solution est enregistrée. Dans les deux cas, les données sont stockées dans le fichier solution (. sln) ou dans le fichier de stockage structuré dans le répertoire des profils utilisateur.

Lorsque l’environnement est arrêté ou qu’un Save All se produit, toutes les valeurs globales sont enregistrées. Si VariablePersists[] est associé à l' DTE objet, la valeur est enregistrée dans le répertoire des options utilisateur de l' Visual Studio environnement.

Si la variable globale est associée à l' Solution objet, la valeur est enregistrée dans le fichier solution (. sln). Les valeurs sont enregistrées chaque fois que l’environnement écrit le fichier. sln.

Toutes les variables enregistrées remplacent les valeurs précédemment enregistrées. Pour supprimer une variable du fichier enregistré, affectez VariablePersists[] à la valeur false . L’environnement supprimera sa valeur lors de l' Save opération suivante.

Notes

VariableValue[] les noms ne peuvent pas contenir d’espaces. Si c’est le cas, vous recevez l’erreur, la valeur n’est pas comprise dans la plage attendue.

S’applique à