Odnajdowanie kodu za pomocą modelu kodu (Visual Basic)
Dodatki Visual Studio zostały zaniechane w programie Visual Studio 2013.Dodatki należy uaktualniać do pakietu rozszerzenia VSPackage.Aby uzyskać więcej informacji na temat uaktualniania, zobacz Często zadawane pytania: konwertowanie dodatków na rozszerzenia pakietu VSPackage.
Visual Studio Model kodu oferuje klientom automatyzacji możliwość odkrycia definicji kodów w projekcie i zmodyfikowania tych elementów kodu.Po dokonaniu modyfikacji w edytorze kodu model kodu automatycznie aktualizuje wszystkie obiekty.Na przykład, jeśli odwołujesz się do obiektu klasy, a użytkownik później dodaje nową funkcję, jest ona wyświetlana wśród elementów członkowskich.Model kodu umożliwia klientom automatyzacji uniknięcie wykonania parser dla Visual Studio języków, aby odkryć definicje wysokiego szczebla w projekcie, takich jak klasy, interfejsy, struktury, metody, właściwości i tak dalej.
Visual Studio Model rdzenia kodu unika obszarów kod języka, więc, na przykład nie podaje modelu obiektu dla instrukcji w funkcjach ani nie podaje pełnych szczegółów dotyczących parametrów.W przypadku parametrów, model kodu udostępnia tylko typ i nazwę parametru i nie dostarcza żadnych informacji na temat czy jest to parametr danych wejściowych, wyjściowych, opcjonalny i tak dalej.Visual C++ zapewnia to rozszerzoną wersję modelu kodu rdzenia, która jest skierowany głównie do Visual C++ projektów.Aby uzyskać informacje na ten temat, zobacz Model kodu Visual C++.
Badanie i edycja kodu z modelem kodu
Model kodu jest przede wszystkim tekstowy, ponieważ program lub kod w projekcie są przechowywane w plikach tekstowych.Znajdź kod projektu przy użyciu modelu projektu do odwiedzenia każdego elementu projektu, a następnie sprawdź, czy element projektu zawiera kod, za pomocą FileCodeModel.Jeśli elementy projektu zawierają elementy kodu, elementy te mogą zwracać obiekty z edytora, a model kodu może wykorzystać model automatyzacji edytora tekstu do modyfikowania kodu lub wykonać analizy składniowe.Za pomocą modelu obiektów edytora, można żądać element kodu zawierający punkt wstawiania edytora lub obiekt TextPoint na poziomie funkcji lub klasy.
Punkt wejścia podstawowy, Visual Studio jest modelem kodu core CodeModel obiektu.Kolekcja ogólna CodeElements jest używana w kilku miejscach w modelu kodu.Znajduje się na CodeElements poziomie i na poziomie klasy lub interfejsu, który zwraca elementy członkowskie z tych obiektów.Każdy element kolekcji CodeElements jest obiektem CodeElement2, a każdy obiekt CodeElement2 posiada właściwość Kind, która identyfikuje jego typ, czy jest to klasa, interfejs, strukturę, funkcję, właściwość, zmienną i tak dalej.
Modele kodu specyficznego dla języka
Visual C++ oferuje rozszerzenie modelu rdzenia kodu do obiektu docelowego Visual C++-określonego kodu.Na przykład jeśli Language wskazuje, że dany element kodu jest obiektu modelu kodu Visual C++ i Kind = vsCMElementClass, wówczas można wybrać QueryInterface (QI) dla CodeClass z modelu kodu Visual Studio lub QI dla VCCodeClass z modelu kodu określonego języka Visual C++.Aby uzyskać więcej informacji o modelu kodu specyficznego dla Visual C++, zobacz Porady: manipulowanie kodem za pomocą modelu kodu Visual C++ (Visual Basic) i Model kodu Visual C++.
Uwagi dla modelu kodu Visual Studio Core
Tylko Visual C++ wykonuje kod modelu implementacji języka modelowania implementacji języka Microsoft.
Implementacje niektórych języków nie implementują w pełni Visual Studio modelu kodu.Tematy pomocy zwracają uwagę na wyjątki, jeśli takie istnieją.Większość różnic między implementacjami modelu kodu istnieje ze względu na różnice funkcjonalne między językami.Na przykład, nie można dodać funkcji do obiektów CodeNamespace w Visual Basic lub Visual C# ponieważ tylko Visual C++ cechuje się definicjami funkcji najwyższego poziomu.
Opis
Ten dodatek przedstawia instruktaż różnych elementów kodu Visual Studio pliku.Aby uruchomić przykład, należy najpierw otworzyć plik kodu źródłowego w edytorze kodu Visual Studio.Aby uzyskać więcej informacji na temat sposobu uruchamiania przykładów, zobacz Porady: kompilowanie i uruchamianie kodu modelu obiektów automatyzacji — przykłady.
Kod
' Add-in code.
Public Sub OnConnection(ByVal application As Object, ByVal _
connectMode As ext_ConnectMode, ByVal addInInst As Object, _
ByRef custom As Array) Implements IDTExtensibility2.OnConnection
_applicationObject = CType(application, DTE2)
_addInInstance = CType(addInInst, AddIn)
' Pass the applicationObject member variable to the code example.
OutlineCode(_applicationObject)
End Sub
Sub OutlineCode(ByVal dte As DTE2)
Dim fileCM As FileCodeModel2 _
= CType(dte.ActiveDocument.ProjectItem.FileCodeModel, _
FileCodeModel2)
Dim elts As CodeElements
elts = fileCM.CodeElements
Dim elt As CodeElement2
Dim i As Integer
MsgBox("About to walk top-level elements ...")
For i = 1 To fileCM.CodeElements.Count
elt = CType(elts.Item(i), CodeElement2)
CollapseElt(elt, elts, i)
Next
End Sub
Sub CollapseElt(ByVal elt As CodeElement2, ByVal elts As _
CodeElements, ByVal loc As Long)
Dim epStart As EditPoint2
Dim epEnd As EditPoint2
epStart = CType(elt.StartPoint.CreateEditPoint, EditPoint2)
' Do this since we move it later.
epEnd = CType(elt.EndPoint.CreateEditPoint, EditPoint2)
epStart.EndOfLine()
If ((elt.IsCodeType) And (elt.Kind <> _
vsCMElement.vsCMElementDelegate)) Then
MsgBox("Got type but not a delegate, named : " & elt.Name)
Dim ct As CodeType
ct = CType(elt, CodeType)
Dim mems As CodeElements
mems = ct.Members
MsgBox("Set mems = ct.members")
Dim i As Integer
For i = 1 To ct.Members.Count
CollapseElt(CType(mems.Item(i), CodeElement2), mems, i)
Next
ElseIf (elt.Kind = vsCMElement.vsCMElementNamespace) Then
MsgBox("Got a namespace, named: " & elt.Name)
Dim cns As CodeNamespace
cns = CType(elt, CodeNamespace)
MsgBox("set cns = elt, named: " & cns.Name)
Dim mems_vb As CodeElements
mems_vb = cns.Members
MsgBox("Got cns.members")
Dim i As Integer
For i = 1 To cns.Members.Count
CollapseElt(CType(mems_vb.Item(i), CodeElement2), _
mems_vb, i)
Next
End If
End Sub
Można zmieniać wartości elementów modelu kodu
Przypisane wartości elementów modelu kodu, takich jak klasy, struktury, funkcje, atrybuty, delegaci i tak dalej, mogą ulec zmianie po wprowadzeniu niektórych rodzajów edycji.W związku z tym, nie można zakładać, że wartości pozostaną niezmienne.
Na przykład, jeśli przypiszesz element modelu kodu do zmiennej lokalnej, a następnie ustawisz wartość właściwości dla tej zmiennej lokalnej, zmienna lokalna może nie zawierać prawidłowego elementu modelu kodu, przy późniejszym odwołaniu.W rzeczywistości może nawet zawierać inny element modelu kodu.
Rozważ klasę zawierająca funkcję o nazwie „MyFunction”, która jest przypisana do zmiennej CodeFunction, a następnie właściwość NameCodeFunction jest ustawiona na wartość „YourFunction”. Po przypisaniu zmiennej zadania, nie jest już zagwarantowane, że zmienna lokalna reprezentuje tę samą CodeFunction.Następnie dostęp do wartości właściwości może zwracać E_FAIL w wyniku.
Zalecane podejście radzenia sobie z tą sytuacją, to jasne ponowne przypisanie zmiennej lokalnej z do poprawnego elementu modelu kodu przed uzyskaniem dostępu do jego wartości właściwości.Poniższy kod przedstawia przykład sposobu wykonania. (Kod jest w formie dodatku).
Opis
Ten dodatek przedstawia właściwy sposób dostępu do wartości dla CodeElements, aby pobrać poprawną wartość.Aby uzyskać więcej informacji na temat sposobu uruchamiania przykładów, zobacz Porady: kompilowanie i uruchamianie kodu modelu obiektów automatyzacji — przykłady.
Kod
[Visual Basic]
Public Sub OnConnection(ByVal application As Object, ByVal _
connectMode As ext_ConnectMode, ByVal addInInst As Object, _
ByRef custom As Array) Implements IDTExtensibility2.OnConnection
_applicationObject = CType(application, DTE2)
_addInInstance = CType(addInInst, AddIn)
ReassignValue(_applicationObject)
End Sub
Sub ReassignValue(ByVal dte As DTE2)
' Before running, create a new Windows application project,
' and then add a function to it named MyFunction.
Try
Dim myFCM As FileCodeModel = _
dte.ActiveDocument.ProjectItem.FileCodeModel
' Change the MyFunction name in Form1 class to
' the name, OtherFunction.
Dim myClass1 As CodeClass = _
CType(myFCM.CodeElements.Item("Form1"), CodeClass2)
Dim myFunction As CodeFunction = _
CType(myClass1.Members.Item("MyFunction"), CodeFunction2)
myFunction.Name = "OtherFunction"
myFunction = CType(myClass1.Members.Item("OtherFunction"), _
CodeFunction2)
Catch ex As Exception
MsgBox(ex.ToString)
End Try
End Sub
[C#]
public void OnConnection(object application, ext_ConnectMode
connectMode, object addInInst, ref Array custom)
{
_applicationObject = (DTE2)application;
_addInInstance = (AddIn)addInInst;
ReassignValue(_applicationObject);
}
// Before running, create a new Windows application project,
// and then add a function to it named MyFunction.
public void ReassignValue(DTE2 dte)
{
try
{
FileCodeModel myFCM =
dte.ActiveDocument.ProjectItem.FileCodeModel;
// Change the MyFunction name in Form1 class to
// the name, OtherFunction.
CodeClass myClass1 =
(CodeClass2)myFCM.CodeElements.Item("Form1");
CodeFunction myFunction =
(CodeFunction2)myClass1.Members.Item("MyFunction");
myFunction.Name = "OtherFunction";
myFunction =
(CodeFunction2)myClass1.Members.Item("OtherFunction");
}
catch (Exception ex)
{
System.Windows.Forms.MessageBox.Show(ex.Message);
}
}
[!UWAGA]
Ustawianie właściwości elementów podrzędnych elementu modelu kodu nie przedstawia tego zachowania.Tylko te właściwości, które mają bezpośredni wpływ na CodeElement — takie jak nazwa elementu, typ funkcji, podpis metody itd — wykazują to zachowanie nie-deterministyczne.
Ponadto, ten przykład działa tylko wtedy, gdy nowa nazwa CodeElement jest unikatowa wśród elementów równorzędnych.To dlatego, Item właściwość zwraca pierwsze dopasowanie, która nie działa dla przeciążonej metody/właściwości, częściowe klasy lub obszary nazw o tej samej nazwie.
Zobacz też
Zadania
Porady: kompilowanie przykładowego kodu dla rozszerzalności modelu kodu Visual C++
Porady: manipulowanie kodem za pomocą modelu kodu Visual C++ (Visual C#)
Koncepcje
Odnajdowanie kodu za pomocą modelu kodu (Visual C#)
Wykres modelu obiektów automatyzacji
Inne zasoby
Tworzenie i kontrolowanie okien środowiska