Globals.VariableExists-Eigenschaft

Artikel
08/10/2011

Gibt zurück, ob die angegebene Variable vorhanden ist.

Namespace: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)

Syntax

'Declaration
ReadOnly Property VariableExists ( _
    Name As String _
) As Boolean
    Get

bool this[
    string Name
] { get; }

property bool VariableExists[String^ Name] {
    bool get (String^ Name);
}

abstract VariableExists : bool

JScript unterstützt keine indizierten Eigenschaften.

Parameter

Name
Typ: System.String
Erforderlich.Stellt den Namen der Variablen dar.

Eigenschaftswert

Typ: System.Boolean
Ein boolescher Wert, der true lautet, wenn die Variable vorhanden ist, und andernfalls false.

Hinweise

Wenn Sie versuchen, den Wert einer nicht vorhandenen Variablen mit der VariableValue-Eigenschaft zu überprüfen, wird eine neue Variable mit dem betreffenden Namen und einem NULL-Wert erstellt. Verwenden Sie zur Unterscheidung zwischen einer leeren und einer nicht vorhandenen Variablen die VariableExists-Eigenschaft.

Für Variablen gilt Folgendes:

Sie weisen hinsichtlich der Länge keine anderen Beschränkungen als die des Systems auf.
Groß- und Kleinschreibung wird nicht berücksichtigt.
Alle im System zulässigen Zeichen können enthalten sein.
Sie sind auf einfache Datentypen wie Zeichenfolgen und Zahlen beschränkt. Es können keine SafeArrays-Schnittstellen oder IDispatch-Schnittstellen verwendet werden.

Beispiele

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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.