Metoda CodeEnum.AddMember —

Artykuł
05/17/2015

Tworzy nowe konstrukcje kodu Członkowskich i wstawia kod odpowiedniej lokalizacji.

Przestrzeń nazw: EnvDTE
Zestaw: EnvDTE (w EnvDTE.dll)

Składnia

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

Wymagane.Nazwa nowego członka.

Value
Typ: Object

Opcjonalne.InitExpression z zwrócony CodeVariable obiektu.Każde pozwolenie na wywóz mogą być przekazywane w albo jako ciąg znaków lub obiekt wyrażenia.

Position
Typ: Object

Opcjonalne.Domyślnie = 0.Element kodu, po którym ma być dodany nowy element.Jeśli wartość jest CodeElement, a następnie dodaje się nowy element natychmiast po.

Jeśli wartość jest typu danych Long AddMember wskazuje element, po którym ma być dodany nowy element.

Ponieważ zbiory rozpocząć ich licznik na 1, przekazując 0 wskazuje, że nowy element powinien być umieszczony na początku kolekcji.Wartość-1 oznacza element powinny być umieszczane na końcu.

Wartość zwracana

Typ: EnvDTE.CodeVariable
A CodeVariable object.

Uwagi

AddMemberDodaje element członkowski do wyliczenia i zwraca CodeVariable obiekt z IsConstant ustawiona na true.

Podczas ustawiania Value ciąg, AddMember wstawia wszelkie wymagane składni, takie jak znaki równości lub średnikami, jeśli zmienna nie jest już wyrażenie inicjalizacji.W zależności od języków i w składni lub semantyczne kontroli wykonywanych na przekazany ciąg ustawienie tego argumentu może zakończyć się niepowodzeniem.Języki nie są wymagane do sprawdzania ciąg i ponieważ ciąg jest niekoniecznie zależnych od języka, ustawienie tego argumentu może spowodować niezdefiniowane zachowanie Jeśli ciąg zawiera dowolną zawartość źle.

Podczas ustawiania Value do CodeElement, czy CodeElement nowo utworzone zależy od wdrożenia modelu kodu języka.W przypadku niektórych języków może wdrożyć semantykę kopiowania, jeśli przekażemy w elemencie kod, który jest już w pliku źródłowym.

Poprawność argumentów jest określana przez język za model kodu.

[!UWAGA]

Wartości elementów modelu kodu, takich jak klasy, struktury, funkcji, atrybuty, delegatów, nie może opierać się na pozostają takie same na wszystkich razy.Aby uzyskać więcej informacji, zobacz sekcję wartości elementu modelu kod można zmienić w Odnajdowanie kodu za pomocą modelu kodu (Visual Basic).

Przykłady

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

Zabezpieczenia programu .NET Framework

Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.