Método CodeEnum.AddMember

Artigo
08/01/2011

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 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 é um CodeElement, em seguida, o novo elemento é adicionado imediatamente após o proprietário.
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 a 0 indica que o novo elemento deve ser colocado no início da coleção.Um valor de-1 significa que o elemento deve ser colocado no final.

Valor de retorno

Tipo: EnvDTE.CodeVariable
A CodeVariable objeto.

Comentários

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

Ao definir Value para uma seqüência de caracteres AddMember insere qualquer sintaxe necessária, como 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 sintáticas ou semânticas verificações realiza a seqüência no passado, 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 formados.

Ao definir Value para um CodeElement, se a 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 já está em um arquivo de origem.

A correção dos argumentos é determinada pelo idioma por trás do 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 alteradas nas 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.