Globals.VariablePersists الخاصية

مقالة
09/21/2010

VariablePersistsتنطبق خاصية إلى عدة أنواع من Globalsالكائنات. ل DTE.Globalsالكائن، فإنه يحصل على أو تعيين ما إذا كان المتغير هو الاحتفاظ ببيئة و هو متوفرة بين جلسات العمل في بيئة. ل Solution.Globalsالكائن، فإنه يحصل على أو تعيين ما إذا كان المتغير هو الاحتفاظ بالبيئة و هو متوفرة بين جلسات عمل للبيئة وبين تحميل وإلغاء تحميل للحل. ل Project.Globalsالكائن، فإنه يحصل على أو تعيين ما إذا كان المتغير هو الاحتفاظ بالبيئة في ملف مشروع.

مساحة الاسم: EnvDTE
التجميع: EnvDTE (في EnvDTE.dll)

بناء الجملة

'إقرار
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

لا تدعم JScript الخصائص المفهرسة.

المعلمات

VariableName
النوع: System.String
مطلوبة.يمثل اسم المتغير إلى الاحتفاظ بها.

قيمة الخاصية

النوع: System.Boolean
القيمة منطقية تشير إلى سواء متغير موجود.VariablePersistsإرجاعtrueفي حالة وجود متغير، وإلا سيتم إرجاعfalse.

ملاحظات

على الرغم من أن المتغيرات العمومية تستمر دائماً في جلسة عمل من Visual Studio، VariablePersistsتسمح هذه المتغيرات إلى أن تستمر بين جلسات العمل.

ملاحظة

إلى حفظ المتغيرات بحل معين، استخدم DTE.Solution.Globals.

إذا كان متغير غير موجود، VariablePersistsتقوم بإرجاع false.

ل Solutionالكائن ( Solution.Globals)، بيانات هو تم الحفظ كلما الحل هو المحفوظة. تعديل Globalsيؤدي كائن ملف الحل يصبح وضع علامة على أنها تم تحريره (أو "dirty"). ل DTEالكائن ( DTE.Globals)، بيانات هو أما عند تم الحفظ Visual Studioبيئة هو إيقاف تشغيل أو إلى حل هو تم الحفظ. وفي كلتا الحالتين، بيانات هو مخزنة في ملف الحل (.sln) أو في ملف التخزين مصنفة في الدليل "ملفات تعريف المستخدمين".

عند بيئة هو إغلاق لأسفل أو Save Allحدوث، يتم تم الحفظ الجميع قيم العالمية. إذا VariablePersistsهو المقترنة DTEالكائن، القيمة هو تم الحفظه في الدليل خيارات مستخدم Visual Studioبيئة.

إذا كان المتغير العمومي المقترن Solutionالكائن، ثم القيمة المحفوظة في ملف الحل (.sln). يتم تم الحفظ قيم أي وقت كتابة بيئة.sln ملف.

أي تم الحفظ المتغيرات بالكتابة فوق سابقا تم الحفظ قيم. إلى إزالة متغير من ملف محفوظ مجموعة VariablePersistsإلى false. سيزيل بيئة الخاصة به القيمة أثناء التالي Saveتشغيل.

ملاحظة

VariableValueلا يمكن أن تتضمن أسماء مسافات. إذا أدى واحد، يحصل الخطأ، لا تقع القيمة ضمن النطاق المتوقع.

أمثلة

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.

الثقة الكاملة للمتصل الفوري. يتعذر استخدام هذا العضو بواسطة التعليمات البرمجية الموثوق بها جزئيًا. لمزيد من المعلومات، راجع باستخدام مكتبات من تعليمات برمجية موثوق بها جزئي.