Arbeiten mit einem Arbeitsbereich

Die Ebene des Arbeitsbereichs stellt einen Startpunkt für die Codeanalyse und das Refactoring ganzer Projektmappen dar. Auf dieser Ebene unterstützt Sie die Arbeitsbereich-API bei der Aufteilung der Informationen zu den Projekten in einer Projektmappe in einzelne Objektmodelle. Sie gewährt Ihnen direkten Zugriff auf die Objektmodelle auf Compilerebene wie Quelltext, Syntaxstrukturen, Semantikmodelle und Kompilierungen, ohne dabei Dateien zu analysieren, Optionen zu konfigurieren oder Abhängigkeit zwischen einzelnen Projekten zu verwalten.

Hostumgebungen wie eine IDE stellen einen Arbeitsbereich für zugehörige geöffnete Projektmappen zur Verfügung. Außerdem kann dieses Modell außerhalb einer IDE verwendet werden, wenn Sie eine Projektmappendatei laden.

Arbeitsbereich

Bei einem Arbeitsbereich handelt es sich um eine aktive Darstellung Ihrer Projektmappe als Auflistung von Projekten, die alle Auflistungen von Dokumenten enthalten. Arbeitsbereiche werden in der Regel an Hostumgebungen gebunden, die sich stetig verändern, während ein Benutzer eine Eingabe macht oder Eigenschaften verändert.

Der Workspace stellt Zugriff auf das aktuelle Projektmappenmodell zur Verfügung. Wenn in der Hostumgebung eine Änderung vorgenommen wird, löst der Arbeitsbereich passende Ereignisse aus, und die Workspace.CurrentSolution-Eigenschaft wird aktualisiert. Wenn z.B. der Benutzer in einem Text-Editor eine Eingabe macht, die einem der Quelldokumente entspricht, verwendet der Arbeitsbereich ein Ereignis, um zu signalisieren, dass das gesamte Modell einer Projektmappe geändert wurde und welches Dokument geändert wurde. Sie können dann mit diesen Änderungen umgehen, indem Sie das neue Modell auf Richtigkeit prüfen, wobei wichtige Bereiche hervorgehoben werden oder Sie Vorschläge für Codeänderungen machen.

Außerdem können Sie eigenständige Arbeitsbereiche erstellen, deren Verbindung mit der Hostumgebung getrennt wird, oder die in einer Anwendung ohne Hostumgebung verwendet werden.

Lösungen, Projekte und Dokumente

Obwohl Arbeitsbereiche sich jedes Mal verändern können, wenn eine Taste gedrückt wird, können Sie mit einem separaten Modell der Projektmappe arbeiten.

Bei einer Projektmappe handelt es sich um ein nicht veränderbares Modell des Projekts und der Dokumente. Das bedeutet, dass das Modell ohne Sperren oder Duplikate freigegeben werden kann. Sobald Sie eine Projektmappeninstanz von der Workspace.CurrentSolution-Eigenschaft erhalten haben, wird diese Instanz nicht mehr verändert. Trotzdem können Sie wie bei Syntaxstrukturen und Kompilierungen Projektmappen verändern, indem Sie neue Instanzen basierend auf bereits vorhandenen Projektmappen und bestimmten Änderungen erstellen. Damit der Arbeitsbereich Ihre Änderungen anzeigt, müssen Sie die veränderte Projektmappe explizit auf den Arbeitsbereich anwenden.

Projekte sind Bestandteile des gesamten nicht veränderbaren Projektmappenmodells. Sie stellen alle Quellcodedokumente, Analysen und Kompilierungsoptionen sowie Assemblyverweise und Verweise zwischen den einzelnen Projekten dar. Über ein Projekt können Sie auf die zugehörige Kompilierung zugreifen. Dabei müssen Sie keine Projektabhängigkeiten festlegen oder Quelldateien analysieren.

Dokumente sind ebenfalls Bestandteile des gesamten nicht veränderbaren Projektmappenmodells. Dokumente stellen einzelne Quelldateien dar, über die Sie auf den Text in der Datei, die Syntaxstruktur und das Semantikmodell zugreifen können.

Im folgenden Diagramm wird deutlich, in welcher Beziehung der Arbeitsbereich zu der Hostumgebung und den Tools steht und wie Bearbeitungen vorgenommen werden.

Zusammenfassung

Roslyn stellt mehrere Compiler-APIs und Arbeitsbereich-APIs zur Verfügung, die umfangreiche Informationen über Ihren Quellcode zur Verfügung stellen und uneingeschränkt mit den Sprachen C# und Visual Basic zusammenarbeiten. Das .NET Compiler Platform SDK vereinfacht die Erstellung von codeabhängigen Tools und Anwendungen um ein Vielfaches. Dieses schafft viele Möglichkeiten für Innovationen in Bereichen wie Metaprogrammierung, Codegenerierung und -transformation, die interaktive Verwendung der Programmiersprachen C# und Visual Basic und die Einbettung von C# und Visual Basic in domänenspezifische Sprachen.