Dateischachtelung im Projektmappen-Explorer

Der „Lösungs-Explorer“ schachtelt verwandte Dateien zur besseren Organisation und um die Auffindbarkeit zu erleichtern. Wenn Sie z. B. einem Projekt ein Windows Forms-Formular hinzufügen, wird die Codedatei für das Formular im Lösungsexplorer unter dem Formular geschachtelt. In .NET Core-Projekten (und .NET 5 und höher) können Dateischachtelungen einen Schritt weiter ausgeführt werden. Sie können zwischen den Dateischachtelungseinstellungen Aus, Standard und Web wählen. Sie können auch anpassen, wie Dateien geschachtelt werden , oder lösungsspezifische und projektspezifische Einstellungen erstellen.

Optionen für die Dateischachtelung

Die verfügbaren Optionen für die nicht anpassbare Dateischachtelung sind folgende:

• Aus: Mit dieser Option erhalten Sie eine flache Liste von Dateien ohne jegliche Verschachtelung.

• Standard: Mit dieser Option erhalten Sie das Standardverhalten für die Dateiverschachtelung im Lösungs-Explorer. Wenn für einen bestimmten Projekttyp keine Einstellungen vorhanden sind, werden keine Dateien im Projekt geschachtelt. Wenn Einstellungen vorhanden sind (z.B. für ein Webprojekt), wird die Verschachtelung angewendet.

• Web: Diese Option wendet das Verhalten des Webdateischachtelungsverhaltens auf alle Projekte in der aktuellen Lösung an. Es hat zahlreiche Regeln, und wir empfehlen Ihnen, es auszuchecken und uns mitzuteilen, was Sie denken. Der folgende Screenshot zeigt nur ein paar Beispiele für das Dateischachtelungsverhalten, das Sie mit dieser Option erhalten:

  

  

Anpassen der Dateischachtelung

Konzentrieren wir uns auf den Knoten dependentFileProviders und seine untergeordneten Knoten. Jeder untergeordnete Knoten ist ein Regeltyp, den Visual Studio zum Schachteln von Dateien verwenden kann. Beispielsweise ist der gleiche Dateiname, aber mit einer anderen Erweiterung eine Art Regel. Die verfügbaren Regeln sind:

• extensionToExtension: Verwenden Sie diese Art von Regel, um file.js unter file.ts zu verschachteln

• fileSuffixToExtension: Verwenden Sie diesen Regeltyp, um file-vsdoc.js unter file.js zu verschachteln.

• addedExtension: Verwenden Sie diesen Regeltyp, um file.html.css unter file.html zu schachteln

• pathSegment: Verwenden Sie diesen Regeltyp zum Schachteln von jquery.min.js unter jquery.js

• allExtensions: Verwenden Sie diesen Regeltyp zum Schachteln von Dateien.* unter file.js

• fileToFile: Verwenden Sie diesen Regeltyp, um bower.json unter .bowerrc zu verschachteln.

Der extensionToExtension-Anbieter

Mit diesem Anbieter können Sie Dateischachtelungsregeln mithilfe bestimmter Dateierweiterungen definieren. Betrachten Sie das folgenden Beispiel:

• file.js wird aufgrund der ersten ExtensionToExtension-Regel unter file.ts geschachtelt.

• file.js ist nicht unter file.tsx geschachtelt, weil .ts vor .tsx in den Regeln vorkommt und es nur ein übergeordnetes Element geben kann.

• light.css ist unter light.sass aufgrund der zweiten extensionToExtension-Regel geschachtelt.

• home.html wird unter home.md geschachtelt, weil die dritte ExtensionToExtension-Regel dies erfordert.

Der FileSuffixToExtension-Anbieter

Dieser Anbieter funktioniert genau wie der ExtensionToExtension-Anbieter , wobei der einzige Unterschied besteht, dass die Regel das Suffix der Datei anstelle der Erweiterung betrachtet. Betrachten Sie das folgenden Beispiel:

• portal-vsdoc.js wird aufgrund der FileSuffixToExtension-Regel unter portal.js geschachtelt.

• Jeder andere Aspekt der Regel funktioniert genauso wie extensionToExtension.

Der addedExtension-Anbieter

Dieser Anbieter schachtelt Dateien mit einer zusätzlichen Erweiterung unter der Datei ohne zusätzliche Erweiterung. Die zusätzliche Erweiterung kann nur am Ende des vollständigen Dateinamens angezeigt werden.

Betrachten Sie das folgenden Beispiel:

• file.html.css wird aufgrund der addedExtension-Regel unter file.html geschachtelt.

Der PathSegment-Anbieter

Dieser Anbieter schachtelt Dateien mit einer zusätzlichen Erweiterung unter einer Datei ohne zusätzliche Erweiterung. Die zusätzliche Erweiterung kann nur in der Mitte des vollständigen Dateinamens angezeigt werden.

Betrachten Sie das folgenden Beispiel:

• jquery.min.js ist aufgrund der PathSegment-Regel unter jquery.js geschachtelt.

Der allExtensions-Anbieter

Mit diesem Anbieter können Sie Dateischachtelungsregeln für Dateien mit jeder Erweiterung, aber mit demselben Basisdateinamen definieren. Betrachten Sie das folgenden Beispiel:

• Template.cs und Template.doc werden aufgrund der AllExtensions-Regel unter Template.tt geschachtelt.

Der FileToFile-Anbieter

Mit diesem Anbieter können Sie Dateischachtelungsregeln basierend auf vollständigen Dateinamen definieren. Betrachten Sie das folgenden Beispiel:

• file.npmrc ist aufgrund der FileToFile-Regel unter package.json geschachtelt.

Regelreihenfolge

Die Sortierung ist in jedem Teil Ihrer benutzerdefinierten Einstellungsdatei wichtig. Sie können die Reihenfolge ändern, in der Regeln ausgeführt werden, indem Sie sie innerhalb des abhängigEnFileProvider-Knotens nach oben oder unten verschieben. Wenn Sie beispielsweise eine Regel haben, die file.js zum übergeordneten Element von file.ts macht, und eine andere Regel haben, die file.coffee zum übergeordneten Element von file.ts macht, bestimmt die Reihenfolge, in der sie in der Datei angezeigt werden, das Schachtelungsverhalten, wenn alle drei Dateien vorhanden sind. Da file.ts nur über ein übergeordnetes Element verfügen kann, gewinnt die Regel, die zuerst ausgeführt wird.

Die Sortierung ist auch für Regelabschnitte selbst wichtig, nicht nur für Dateien innerhalb eines Abschnitts. Sobald ein Dateipaar mit einer Dateischachtelungsregel übereinstimmt, werden andere Regeln weiter unten in der Datei ignoriert, und das nächste Dateipaar wird verarbeitet.

Schaltfläche für die Dateischachtelung

Sie können alle Einstellungen, einschließlich Ihrer eigenen benutzerdefinierten Einstellungen, über dieselbe Schaltfläche im Projektmappen-Explorer verwalten:

Erstellen projektspezifischer Einstellungen

Lösungsspezifische und projektspezifische Einstellungen werden mit den aktiven Visual Studio-Einstellungen kombiniert. Beispielsweise verfügen Sie über eine leere projektspezifische Einstellungsdatei, der Projektmappen-Explorer schachtelt jedoch noch immer Dateien. Das Schachtelungsverhalten stammt entweder aus den projektmappenspezifischen Einstellungen oder den Visual Studio-Einstellungen. Die Rangfolge für das Zusammenführen der Einstellungen für die Dateischachtelung ist: Visual Studio > Projektmappe > Projekt.

Sie können Visual Studio anweisen, nur die lösungsspezifischen oder projektspezifischen Einstellungen zu verwenden, indem Sie den Stammknoten auf true setzen. Visual Studio beendet das Zusammenführen von Dateien auf dieser Ebene und kombiniert sie nicht mit Dateien, die höher oben in der Hierarchie sind.

Lösungsspezifische und projektspezifische Einstellungen können in die Quellcodeverwaltung eingecheckt werden, und das gesamte Team, das an der Codebasis arbeitet, kann sie freigeben.

Deaktivieren der Dateischachtelungsregeln für ein Projekt

Sie können vorhandene globale Dateischachtelungsregeln für bestimmte Lösungen oder Projekte deaktivieren, indem Sie die Entfernen-Aktion für einen Anbieter anstelle des Hinzufügens verwenden. Wenn Sie beispielsweise den folgenden Einstellungscode zu einem Projekt hinzufügen, werden alle PathSegment-Regeln , die global für dieses bestimmte Projekt vorhanden sein können, deaktiviert:

"dependentFileProviders": {
  "remove": {
    "pathSegment": {}
  }
}

Verwandte Inhalte

• Personalisieren der IDE
• Lösungen und Projekte in Visual Studio