Método CodeEnum.AddMember

Artigo
10/26/2012

Cria uma nova construção de código de membro e insere o código no local correto.

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

Sintaxe

'Declaração
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

Parâmetros

Name
Tipo: System.String
Obrigatório.O nome do novo membro.

Value
Tipo: System.Object
Opcional.O InitExpression de retornado CodeVariable objeto.Ele pode ser passado ou como uma seqüência de caracteres ou como um objeto de expressão.

Position
Tipo: System.Object
Opcional.Padrão = 0.O elemento de código após o qual você deseja adicionar o novo elemento.Se o valor for um CodeElement, e em seguida, o novo elemento é adicionado imediatamente após ele.
Se o valor é um tipo de dados longos, em seguida, AddMember indica o elemento após o qual você deseja adicionar o novo elemento.
Porque coleções começam sua contagem em 1, passando de 0 indica que o novo elemento deve ser colocado no início da coleção.O valor-1 significa que o elemento deve ser colocado no final.

Valor de retorno

Tipo: EnvDTE.CodeVariable
A CodeVariable object.

Comentários

AddMemberAdiciona um membro para a enumeração e retorna um CodeVariable de objeto com IsConstant definido como true.

Ao definir Value para uma seqüência de caracteres, AddMember insere qualquer sintaxe necessária, como, por exemplo, sinais de igual ou ponto e vírgula, se a variável ainda não tiver uma expressão de inicialização.Dependendo dos idiomas e de sintaxe ou semânticos verificações que ele executa no passado em seqüência, definir este argumento podem falhar.Idiomas não são necessários para verificar a seqüência de caracteres e como a seqüência de caracteres é necessariamente dependente de idioma, definir este argumento pode resultar em um comportamento indefinido se a seqüência tem qualquer conteúdo mal.

Ao definir Value para um CodeElement, independentemente do CodeElement deve ser criado recentemente depende da implementação de idioma do modelo de código.Alguns idiomas podem implementar a semântica de cópia se você passar em um elemento de código que já está em um arquivo de origem.

A correção dos argumentos é determinada pelo idioma atrás o modelo de código.

Observação
Os valores dos elementos de modelo de código, como, por exemplo, classes, estruturas, funções, atributos, delegados, não confie permaneça o mesmo em todos os tempos.Para obter mais informações, consulte a seção valores de elemento de modelo de código podem ser alterada de Descobrindo o código usando o modelo de código (Visual Basic).

Exemplos

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.