CodeEnum.AddMember – metoda

Článek
05/16/2015

Vytvoří nové konstrukce kódu členské a vloží kód do správného umístění.

Obor názvů: EnvDTE
Sestavení: EnvDTE (v EnvDTE.dll)

Syntaxe

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

Parametry

Name
Typ: String

Povinné.Název nového člena.

Value
Typ: Object

Nepovinné.InitExpression z vrácené CodeVariable objektu.Mohou být předány v buď jako řetězec nebo objekt výraz.

Position
Typ: Object

Nepovinné.Výchozí nastavení = 0.Prvek kódu, po které chcete přidat nový prvek.Pokud je hodnota CodeElement, potom ihned po je přidán nový prvek.

Pokud hodnota je typ dat Long, pak AddMember určuje prvek, po které chcete přidat nový prvek.

Protože kolekce zahájit jejich počet na 1, procházející 0 udává, že nový prvek by měl na začátku kolekce.Hodnota-1 znamená prvek umístit na konci.

Vrácená hodnota

Typ: EnvDTE.CodeVariable
Objekt CodeVariable.

Poznámky

AddMemberPřidá členem výčtu a vrátí CodeVariable objekt s IsConstant nastavena na true.

Při nastavení Value je řetězec, AddMember vloží všechny požadované syntaxi, například znaky rovná nebo středníky, pokud proměnná již nemá inicializační výraz.V závislosti na jazyky a syntaktické nebo sémantické kontroly, které provádí na řetězec předaný, nastavení tohoto argumentu může selhat.Jazyky nevyžadovalo řetězec a řetězec je nutně jazykově závislé, nastavení tohoto argumentu může vést k chování nedefinovaný řetězec má nedůvěryhodný obsah.

Při nastavení Value do CodeElement, zda CodeElement musí být nově vytvořené závisí na provádění modelu kódu jazyka.Některé jazyky mohou provádět kopírování sémantiku předáte v prvku kód, který je již ve zdrojovém souboru.

Správnosti argumentů je určen jazyk za kód modelu.

[!POZNÁMKA]

Hodnoty prvků modelu kód jako třídy, struktury, funkce, atributy, delegátů nelze spoléhat na zůstat stejné na všech časy.Další informace naleznete v části Změna hodnoty prvku modelu kódu Zjišťování kódu pomocí modelu kódu (Visual Basic).

Příklady

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

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.