Metoda CodeFunction2.AddParameter —

Artykuł
05/17/2015

Tworzy nowy konstrukcji kodu parametru i wstawia kod w odpowiedniej lokalizacji.

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

Składnia

'Deklaracja
Function AddParameter ( _
    Name As String, _
    Type As Object, _
    Position As Object _
) As CodeParameter

CodeParameter AddParameter(
    string Name,
    Object Type,
    Object Position
)

CodeParameter^ AddParameter(
    String^ Name, 
    Object^ Type, 
    Object^ Position
)

abstract AddParameter : 
        Name:string * 
        Type:Object * 
        Position:Object -> CodeParameter

function AddParameter(
    Name : String, 
    Type : Object, 
    Position : Object
) : CodeParameter

Parametry

Name
Typ: String

Parametr wymagany.Nazwa parametru.

Type
Typ: Object

Parametr wymagany.Element vsCMTypeRef wskazuje typ danych, które funkcja zwraca stałą.Może to być CodeTypeRef obiektu, vsCMTypeRef stały lub w pełni kwalifikowaną nazwę typu.

Position
Typ: Object

Parametr opcjonalny.Domyślnie = 0.Element kodu, po którym ma być dodany nowy element.Jeśli wartość jest CodeElement, nowego elementu jest dodawana natychmiast po nim.

Jeśli wartość jest wartością typu Long, następnie AddParameter wskazuje element, po którym ma być dodany nowy element.

Ponieważ kolekcje ich liczba zaczyna się od 1, przekazywania 0 oznacza, że nowego elementu należy umieścić na początku kolekcji.Wartość-1 oznacza element powinien być umieszczony na końcu.

Wartość zwracana

Typ: CodeParameter
Obiekt CodeParameter.

Uwagi

Program Visual C++ wymaga formatu rozdzielone dwukropkiem (:) dla jego typu w pełni kwalifikowanej nazwy.Wszystkie inne języki obsługuje formatu oddzielonych okres.

Prawidłowości argumenty zależy od języka za model kodu.

[!UWAGA]

Po wprowadzeniu niektóre rodzaje edycji, co oznacza, że ich wartości nie można polegać na zawsze jednocześnie może być niedeterministyczne wartości elementów modelu kodu, takich jak klasy, struktur, funkcje, atrybutów, delegatów i tak dalej.Aby uzyskać więcej informacji, zobacz sekcję wartości elementów modelu kod można zmienić w Odnajdowanie kodu za pomocą modelu kodu (Visual Basic).

Przykłady

Sub AddParameterExample(ByVal dte As DTE2)

    ' Before running this example, open a code document from a project
    ' and place the insertion point inside a function.
    Try
        ' Retrieve the CodeFunction at the insertion point.
        Dim sel As TextSelection = _
            CType(dte.ActiveDocument.Selection, TextSelection)
        Dim fun As CodeFunction = _
            CType(sel.ActivePoint.CodeElement( _
            vsCMElement.vsCMElementFunction), CodeFunction)

        ' Add a parameter to the function.
        fun.AddParameter("TestParam", vsCMTypeRef.vsCMTypeRefInt)
    Catch ex As Exception
        MsgBox(ex.Message)
    End Try

End Sub

public void AddParameterExample(DTE2 dte)
{
    // Before running this example, open a code document from a project
    // and place the insertion point inside a function.
    try
    {
        // Retrieve the CodeFunction at the insertion point.
        TextSelection sel = 
            (TextSelection)dte.ActiveDocument.Selection;
        CodeFunction fun = 
            (CodeFunction)sel.ActivePoint.get_CodeElement(
            vsCMElement.vsCMElementFunction);

        // Add a parameter to the function.
        fun.AddParameter("TestParam", vsCMTypeRef.vsCMTypeRefInt, -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.