Freigeben über

Erstellen einer VSCT-Datei

  • Artikel

Es gibt mehrere Möglichkeiten zum Erstellen einer XML-basierten Visual Studio-Befehlstabellenkonfigurationsdatei (VSCT).

  • Sie können ein neues VSPackage in der Visual Studio-Paketvorlage erstellen.

  • Sie können den XML-basierten Befehlstabellenkonfigurationscompiler Vsct.exe verwenden, um eine Datei aus einer vorhandenen CTC-Datei zu generieren.

  • Sie können Vsct.exe verwenden, um eine VSCT-Datei aus einer vorhandenen CTO-Datei zu generieren.

  • Sie können manuell eine neue VSCT-Datei erstellen.

    In diesem Artikel wird erläutert, wie Sie manuell eine neue VSCT-Datei erstellen.

So erstellen Sie manuell eine neue VSCT-Datei

  1. Starten Sie Visual Studio.

  2. Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Datei.

  3. Klicken Sie im Bereich "Vorlagen " auf "XML-Datei " und dann auf " Öffnen".

  4. Klicken Sie im Menü "Ansicht " auf "Eigenschaften ", um die Eigenschaften der XML-Datei anzuzeigen.

  5. Klicken Sie im Eigenschaftenfenster auf die Schaltfläche "Durchsuchen " in der Schemas-Eigenschaft .

  6. Wählen Sie in der Liste der XSD-Schemas das Schema "vsct.xsd " aus. Wenn sie nicht in der Liste enthalten ist, klicken Sie auf "Hinzufügen", und suchen Sie dann die Datei auf einem lokalen Laufwerk. Klicken Sie auf OK, wenn Sie fertig sind.

  7. Geben Sie in der XML-Datei "CommandTable" ein, und drücken Sie dann die TAB-TASTE.< Schließen Sie das Tag durch Eingabe>.

    Diese Aktion erstellt eine einfache VSCT-Datei .

  8. Füllen Sie die Elemente der XML-Datei aus, die Sie hinzufügen möchten, entsprechend der VSCT-XML-Schemareferenz. Weitere Informationen finden Sie unter "Author.vsct"-Dateien.

Erstellen einer VSCT-Datei aus einer vorhandenen CTC-Datei

Sie können eine XML-basierte VSCT-Datei aus einer vorhandenen Befehlstabellen-CTC-Quelldatei erstellen. Dadurch können Sie das neue XML-basierte Visual Studio-Befehlstabellen-Compilerformat (VSCT) nutzen.

So erstellen Sie eine VSCT-Datei anhand einer CTC-Datei

  1. Rufen Sie eine Kopie der Sprache Perl ab.

  2. Rufen Sie eine Kopie des Perl-Skripts ConvertCTCToVSCT.pl ab, in der< Regel im Visual Studio SDK-Installationspfad>\VisualStudioIntegration\Tools\bin-Ordner.

  3. Rufen Sie eine Kopie der CTC-Quelldatei ab, die Sie konvertieren möchten.

  4. Speichern Sie die Dateien im selben Verzeichnis.

  5. Navigieren Sie im Visual Studio-Eingabeaufforderungsfenster zum Verzeichnis.

  6. Typ

    perl.exe ConvertCTCtoVSCT.pl PkgCmd.ctc PkgCmd.vsct

    Dabei ist PkgCmd.ctc der Name der CTC-Datei und PkgCmd.vsct der Name der VSCT-Datei , die Sie erstellen möchten.

    Mit dieser Aktion wird eine neue XML-Befehlstabellenquelldatei erstellt. Sie können die Datei mithilfe von Vsct.exe, dem VSCT-Compiler, wie jede andere VSCT-Datei kompilieren.

    Hinweis

    Sie können die Lesbarkeit der VSCT-Datei verbessern, indem Sie die XML-Kommentare neu formatieren.

Erstellen einer VSCT-Datei aus einer vorhandenen CTO-Datei

Sie können eine XML-basierte VSCT-Datei aus einer vorhandenen binären CTO-Datei erstellen. Diese Vorgehensweise ermöglicht es Ihnen, das neue Befehlstabellen-Compilerformat zu nutzen. Dieser Vorgang funktioniert auch dann, wenn die CTO-Datei aus einer CTC-Datei kompiliert wurde. Sie können die VSCT-Datei in eine andere CTO-Datei bearbeiten und kompilieren.

So erstellen Sie eine VSCT-Datei anhand einer CTO-Datei

  1. Erhalten Sie Kopien der CTO-Datei und der entsprechenden CTSYM-Datei .

  2. Platzieren Sie die Dateien im selben Verzeichnis wie der vsct.exe Compiler.

  3. Wechseln Sie an der Visual Studio-Eingabeaufforderung zu dem Verzeichnis, das die CTO - und CTSYM-Dateien enthält.

  4. Typ

    vsct.exe <ctofilename>.cto <vsctfilename>.vsct -S<symfilename>.ctsym

    dabei <ist ctofilename> der Name der CTO-Datei , <vsctfilename> ist der Name der VSCT-Datei , die Sie erstellen möchten, und <symfilename> ist der Name der CTSYM-Datei .

    Mit diesem Prozess wird eine neue XML-Befehlstabellencompilerdatei erstellt. Sie können die Datei mit vsct.exe, dem vsct Compiler, wie jede andere VSCT-Datei bearbeiten und kompilieren.

Kompilieren des Codes

Das Hinzufügen einer VSCT-Datei zu einem Projekt führt nicht dazu, dass sie kompiliert wird. Sie müssen sie in den Buildprozess integrieren.

So fügen Sie eine VSCT-Datei zur Projektkompilierung hinzu

  1. Öffnen Sie ihre Projektdatei im Editor. Wenn das Projekt geladen wird, müssen Sie es zuerst entladen.

  2. Fügen Sie ein ItemGroup-Element hinzu, das ein VSCTCompile Element enthält, wie im folgenden Beispiel gezeigt.

    <ItemGroup>
  <VSCTCompile Include="TopLevelMenu.vsct">
    <ResourceName>Menus.ctmenu</ResourceName>
  </VSCTCompile>
</ItemGroup>

    Das ResourceName Element sollte immer auf Menus.ctmenu.

  3. Wenn Ihr Projekt eine RESX-Datei enthält, fügen Sie ein EmbeddedResource Element hinzu, das ein MergeWithCTO Element enthält, wie im folgenden Beispiel gezeigt:

    <EmbeddedResource Include="VSPackage.resx">
  <MergeWithCTO>true</MergeWithCTO>
  <ManifestResourceName>VSPackage</ManifestResourceName>
</EmbeddedResource>

    Dieses Markup sollte sich innerhalb des ItemGroup Elements befinden, das eingebettete Ressourcen enthält.

  4. Öffnen Sie die Paketdatei, in der Regel "<ProjectName>Package.cs" oder< "ProjectName>Package.vb", im Editor.

  5. Fügen Sie der Paketklasse ein ProvideMenuResource Attribut hinzu, wie im folgenden Beispiel gezeigt.

    [ProvideMenuResource("Menus.ctmenu", 1)]

    Der erste Parameterwert muss mit dem Wert des Attributs übereinstimmen, das ResourceName Sie in der Projektdatei definiert haben.

Zugehöriger Inhalt