Interfaccia Globals

Globals l'oggetto è una cache per memorizzare i dati per la durata di ciascuna sessione di Visual Studio ambiente nonché tramite l'utilizzo di sessioni VariablePersists proprietà.

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

Sintassi

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

Il tipo Globals espone i seguenti membri.

Proprietà

	Nome	Descrizione
	DTE	Ottiene l'oggetto estensibilità di primo livello.
	Parent	Ottiene l'oggetto padre immediato di un oggetto Globals oggetto.
	VariableExists	Restituisce se la variabile specificata.
	VariableNames	ottiene un elenco di tutti i nomi di variabile globale correnti.
	VariablePersists	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.
	VariableValue	Restituisce o imposta la variabile con il nome specificato.

In alto

Note

Globals oggetto, ad esempio, consente ai programmi hanno variabili globali dei cui valori sono persistenti tra le esecuzioni.Può anche essere utilizzata per consentire un comando implementare un valore predefinito se richiede all'utente di immettere le informazioni ogni volta che eseguono.Inoltre, può essere utilizzata per modificare il comportamento dopo che è stata richiamata un determinato numero di volte.

I dati vengono archiviati in Globals oggetto come coppie variante-valore di nome/valore.Queste coppie nome/valore possono eventualmente essere archiviati sul disco tramite VariablePersists proprietà per gestire il relativo stato (come stringa) tra le sessioni di diversi Visual Studio.

[!NOTA]

Variabili che contengono oggetti o SafeArrays non può essere salvato.Se il valore può essere salvato come stringa, viene salvata nel formato nativo.

componenti aggiuntivi o le macro anche possibile utilizzare Globals oggetto per salvare i dati definiti dall'utente univoci per ogni utente tra Visual Studio sessioni.È possibile utilizzare Globals oggetto per salvare i dati e per recuperare dati da un file di soluzione (sln).

utilizzare VariableValue proprietà per salvare o leggere i valori salvati con Globals oggetto.

[!NOTA]

VariableValue le stringhe del nome non possono contenere uno spazio, i due punti (:), o i caratteri di punto (.).Se il nome è uno di questi caratteri, 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.");
}

Vedere anche

Riferimenti

Spazio dei nomi EnvDTE

Altre risorse

Mantenimento delle informazioni in progetti e soluzioni