Metoda CodeModel.AddDelegate —

Artykuł
10/27/2012

Tworzy nowe konstrukcje kodu delegata i wstawia kod odpowiedniej lokalizacji.

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

Składnia

'Deklaracja
Function AddDelegate ( _
    Name As String, _
    Location As Object, _
    Type As Object, _
    Position As Object, _
    Access As vsCMAccess _
) As CodeDelegate

CodeDelegate AddDelegate(
    string Name,
    Object Location,
    Object Type,
    Object Position,
    vsCMAccess Access
)

CodeDelegate^ AddDelegate(
    String^ Name, 
    Object^ Location, 
    Object^ Type, 
    Object^ Position, 
    vsCMAccess Access
)

abstract AddDelegate : 
        Name:string * 
        Location:Object * 
        Type:Object * 
        Position:Object * 
        Access:vsCMAccess -> CodeDelegate

function AddDelegate(
    Name : String, 
    Location : Object, 
    Type : Object, 
    Position : Object, 
    Access : vsCMAccess
) : CodeDelegate

Parametry

Name
Typ: System.String
Wymagane.Nazwisko pełnomocnika, aby dodać.

Location
Typ: System.Object
Wymagane.Ścieżka i nazwa nowej definicji obiektu delegowanego.W zależności od języka nazwa pliku jest względną lub bezwzględną do pliku projektu.Plik zostanie dodany do projektu, jeśli nie jest już elementu projektu.Jeśli plik nie mogą być utworzone i dodane do projektu, następnie AddDelegate nie powiedzie się.

Type
Typ: System.Object
Wymagane.A vsCMTypeRef stałą wskazującą typ danych, zwracana przez funkcję.Wartość ta może być CodeTypeRef obiektu, vsCMTypeRef stała lub w pełni kwalifikowana nazwa typu.

Position
Typ: System.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 AddDelegate 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, że element powinny być umieszczane na końcu.

Access
Typ: EnvDTE.vsCMAccess
Opcjonalne.A vsCMAccess stałą.

Wartość zwracana

Typ: EnvDTE.CodeDelegate
A CodeDelegate object.

Uwagi

Macierzysty macierzystym Visual C++ wymaga oddzielone dwukropkiem (::) format dla jego typu w pełni kwalifikowanej nazwy, wszystkie inne języki obsługuje format oddzielonych od siebie kropkami.

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

[!UWAGA]

Po dokonaniu niektórych rodzajów modyfikacji, co oznacza, że ich wartości nie może polegać na zawsze pozostawać taki sam może być nie deterministyczny wartości elementów modelu kodu, takich jak klasy, strukturach, funkcje, atrybuty, delegatów i tak dalej.Aby uzyskać więcej informacji, zobacz sekcję wartości elementu modelu kod można zmienić w Odkrywanie kod przy użyciu modelu kodu (Visual Basic).

Przykłady

Sub AddDelegateExample2(ByVal dte As DTE2)

    ' Before running this example, open a code document from a project.
    Try
        Dim projItem As ProjectItem = dte.ActiveDocument.ProjectItem
        Dim cm As CodeModel = projItem.ContainingProject.CodeModel

        ' Create a new delegate.
        cm.AddDelegate("TestDelegate", projItem.Name, _
            vsCMTypeRef.vsCMTypeRefInt)
    Catch ex As Exception
        MsgBox(ex.Message)
    End Try

End Sub

public void AddDelegateExample2(DTE2 dte)
{
    // Before running this example, open a code document from 
    // a project.
    try
    {
        ProjectItem projItem = dte.ActiveDocument.ProjectItem;
        CodeModel cm = projItem.ContainingProject.CodeModel;

        // Create a new delegate.
        cm.AddDelegate("TestDelegate", projItem.Name, 
            vsCMTypeRef.vsCMTypeRefInt, -1, 
            vsCMAccess.vsCMAccessPublic);
    }
    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 Przy użyciu bibliotek z częściowo zaufanego kodu..