Metodo CodeEnum.AddMember

Articolo
10/30/2012

Crea un nuovo costrutto di codice di un membro e inserisce il codice nella posizione corretta.

Spazio dei nomi: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)

Sintassi

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

Parametri

Name
Tipo: System.String
obbligatorio.Il nome del nuovo membro.

Value
Tipo: System.Object
facoltativo.InitExpression dell'oggetto restituito CodeVariable oggetto.Può essere passato sotto forma di stringa o di oggetto espressione.

Position
Tipo: System.Object
facoltativo.Valore predefinito = 0.Elemento di codice dopo il quale deve essere aggiunto il nuovo elemento.Se il valore corrisponde a CodeElement, quindi il nuovo elemento verrà aggiunto immediatamente dopo.
Se il valore è di tipo long, quindi AddMember indica l'elemento dopo il quale deve essere aggiunto il nuovo elemento.
Poiché nelle raccolte il conteggio inizia da 1, un valore 0 indica che il nuovo elemento deve essere inserito all'inizio della raccolta.Il valore -1 indica che l'elemento deve essere inserito alla fine.

Valore restituito

Tipo: EnvDTE.CodeVariable
In CodeVariable oggetto.

Note

AddMember aggiunge un membro all'enumerazione e restituisce un valore CodeVariable oggetto con IsConstant impostare su true.

Quando si impostano Value in una stringa, AddMember inserisce una sintassi di associazione, ad esempio i segni di uguale o punti e virgola, se la variabile non è già presente un'espressione di inizializzazione.A seconda dei linguaggi e i controlli che sintattici o semantici eseguono la stringa passata, impostando questo argomento può non riuscire.I linguaggi non sono necessari controllare la stringa e perché la stringa è necessariamente dipendente dal linguaggio, impostare questo argomento potrebbe provocare un comportamento indefinito se la stringa ha qualsiasi contenuto in atri.

Quando si impostano Value a un oggetto CodeElementse, CodeElement deve essere appena creato dipende dall'implementazione del linguaggio del modello di codice.Alcuni linguaggi possono implementare la semantica di copia se si passa un elemento di codice già presente in un file di origine.

La precisione degli argomenti è determinata dal linguaggio del modello di codice.

[!NOTA]

I valori degli elementi del modello di codice, quali classi, strutture, le funzioni, gli attributi, delegati, non possono essere basati su per rimanere sempre gli stessi.Per ulteriori informazioni, vedere i valori degli elementi del modello di codice della sezione può cambiare in Individuazione di codice mediante il modello di codice (Visual Basic).

Esempi

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.