CodeEnum.AddMember أسلوب

مقالة
09/21/2010

قم بإنشاء عضو جديد تعليمات برمجية بناء وإدراج تعليمات برمجية في الموقع الصحيح.

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

بناء الجملة

'إقرار
Function AddMember ( _
    Name As String, _
    Value As Object, _
    Position As Object _
) As CodeVariable

CodeVariable AddMember(
    string Name,
    Object Value,
    Object Position
)

CodeVariable^ AddMember(
    String^ Name, 
    Object^ Value, 
    Object^ Position
)

abstract AddMember : 
        Name:string * 
        Value:Object * 
        Position:Object -> CodeVariable

function AddMember(
    Name : String, 
    Value : Object, 
    Position : Object
) : CodeVariable

المعلمات

Name
النوع: System.String
مطلوبة.اسم العضو الجديد.

Value
النوع: System.Object
اختياري.InitExpressionمن يتم إرجاع CodeVariableكائن.يمكن أن يكون pكـsed أما كـ سلسلة أو كـ كائن تعبير.

Position
النوع: System.Object
اختياري.الافتراضي = 0.عنصر تعليمات برمجية بعدها إلى إضافة العنصر الجديد.إذا كانت القيمة هو CodeElement، العنصر الجديد ثم هو إضافتها مباشرة بعد it.
إذا كانت القيمة هو نوع بيانات طويلة، ثم AddMemberيشير إلى العنصر بعدها لإضافة عنصر جديد.
يشير لأنه يبدأ مجموعة s بها عدد من 1، تمرير 0 إلى أنه يجب وضع العنصر الجديد في البداية مجموعة.-1 تعني القيمة عنصر يجب أن توضع في النهاية.

القيمة المُرجعة

النوع: EnvDTE.CodeVariable
كائن CodeVariable .

ملاحظات

AddMemberإضافة عضو إلى التعداد و إرجاعCodeVariableكائن معIsConstantتعيين إلىtrue.

عند تعيين Valueإلى سلسلة، AddMemberقم بإدراج أي مطلوب في بناء جملة علامات المساواة أو بفواصل منقوطة، إذا كان المتغير لا يحتوي مسبقاً على تعبير تهيئة. استناداً إلى اللغات و قد تفشل عملية تدقيق syntactic أو دلالية ينفذ تشغيل التي تم تمريرها-في سلسلة، قم بتعيين هذه وسيطة. لغات غير مطلوبة للتحقق من السلسلة، ونظرا لأن السلسلة هو بالضرورة اللغة المعتمدة، إعداد th هو وسيطة قد ينتج سلوك غير معرفة إذا كان أي محتوى تم صحيح ill للسلسلة.

عند تعيين Valueإلى CodeElement، سواء CodeElementيجب إنشاؤها حديثا يعتمد تشغيل تطبيق اللغة من طراز تعليمات برمجية. قد يقوم بعض اللغات بتنفيذ دلالات نسخ إذا قمت بتمرير عنصر التعليمات برمجية التي هو مسبقاً في ملف مصدر.

صحة الوسيطات هو يفرضها اللغة خلف طراز تعليمات برمجية.

ملاحظة

قيم عناصر نموذج تعليمات برمجية مثل فئات بنيات، الدالات، السمات، مفوضين وما إلى ذلك يمكن أن تكون غير محدداً بعد إجراء أنواع معينة من عمليات التحرير، مما يعني أن لا يكون relied قيمها على إلى دائماً تبقى كما هي. لمزيد من في تشكيل، راجع مقطع "تعليمات برمجية طراز عنصر قيم يمكن تغيير" في اكتشاف التعليمات البرمجية باستخدام "نموذج التعليمات البرمجية" (Visual Basic).

أمثلة

Sub AddMemberExample(ByVal dte As DTE2)

    ' Before running this example, open a code document from a project
    ' and place the insertion point inside an enumeration.
    Try
        ' Retrieve the CodeEnum at the insertion point.
        Dim sel As TextSelection = _
            CType(dte.ActiveDocument.Selection, TextSelection)
        Dim enm As CodeEnum = _
            CType(sel.ActivePoint.CodeElement( _
            vsCMElement.vsCMElementEnum), CodeEnum)

        ' Add a member to the enumeration.
        enm.AddMember("TestMember")
    Catch ex As Exception
        MsgBox(ex.Message)
    End Try

End Sub

public void AddMemberExample(DTE2 dte)
{
    // Before running this example, open a code document from a project
    // and place the insertion point inside an enumeration.
    try
    {
        // Retrieve the CodeEnum at the insertion point.
        TextSelection sel = 
            (TextSelection)dte.ActiveDocument.Selection;
        CodeEnum enm = 
            (CodeEnum)sel.ActivePoint.get_CodeElement(
            vsCMElement.vsCMElementEnum);

        // Add a member to the enumeration.
        enm.AddMember("TestMember", null, -1);
    }
    catch (Exception ex)
    {
        MessageBox.Show(ex.Message);
    }
}

أمن NET Framework.

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