Skript-Taghilfsprogramm in ASP.NET Core

  • Artikel

Von Rick Anderson

Das Skript-Taghilfsprogramm generiert einen Link zu einer primären oder Fallback-Skriptdatei. Die primäre Skriptdatei befindet sich in der Regel in einem Content Delivery Network (CDN).

Für ein CDN gilt Folgendes:

  • Es bietet einige Leistungsvorteile im Vergleich zum Hosten einer Ressource mit der Web-App.
  • Es sollte nicht als einzige Quelle für eine Ressource verwendet werden. CDNs sind nicht immer verfügbar, daher sollte eine zuverlässige Fallbackquelle eingerichtet werden. Hierbei handelt es sich üblicherweise um die Website, auf der die Web-App gehostet wird.

Mit dem Skript-Taghilfsprogramm können Sie ein CDN für die Skriptdatei und eine Fallbackquelle angeben, wenn das CDN nicht verfügbar ist. Das Skript-Taghilfsprogramm bietet den Leistungsvorteil eines CDN kombiniert mit der Stabilität des lokalen Hostings.

Im folgenden Razor-Markup wird ein script-Element mit einem Fallback veranschaulicht:

<script src="https://ajax.aspnetcdn.com/ajax/jquery/jquery-3.3.1.js"
        asp-fallback-src="~/lib/jquery/dist/jquery.js"
        asp-fallback-test="window.jQuery"
        crossorigin="anonymous"
        integrity="sha384-tsQFqpEReu7ZLhBV2VZlAu7zcOV+rXbYlF2cqB8txI/8aZajjp4Bqd+V6D5IgvKT">
</script>

Verwenden Sie nicht das defer-Attribut des <script>-Elements, um das Laden des CDN-Skripts auszusetzen. Das Hilfsprogramm für Skripttags rendert JavaScript-Code, der sofort den Ausdruck asp-fallback-test ausführt. Der Ausdruck schlägt fehl, wenn das Laden des CDN-Skripts ausgesetzt wird.

Häufig verwendete Attribute des Skript-Taghilfsprogramms

Sie finden alle Attribute, Eigenschaften und Methoden des Skript-Taghilfsprogramms in der Referenz zur ScriptTagHelper-Klasse.

src

Adresse des zu verwendenden externen Skripts.

asp-append-version

Wenn asp-append-version mit dem Wert true zusammen mit einem src-Attribut angegeben wird, wird eine eindeutige Version generiert.

Informationen darüber, wie ein Taghilfsprogramm eine Version für eine statische Datei außerhalb von wwwroot generiert, finden Sie unter Bereitstellen von Dateien von mehreren Speicherorten.

asp-fallback-src

Die URL eines Skripttags, das als Fallback verwendet wird, falls die primäre URL nicht verfügbar ist.

asp-fallback-src-exclude

Eine durch Trennzeichen getrennte Liste mit Globdateimustern von JavaScript-Skripts, die aus der Fallbackliste ausgeschlossen werden sollen, falls das primäre Skript fehlschlägt. Die Globmuster werden relativ zur webroot-Einstellung der Anwendung bewertet. Muss zusammen mit asp-fallback-src-include verwendet werden.

asp-fallback-src-include

Eine durch Trennzeichen getrennte Liste mit Globdateimustern von JavaScript-Skripts, auf die ein Fallback ausgeführt werden soll, falls das primäre Skript fehlschlägt. Die Globmuster werden relativ zur webroot-Einstellung der Anwendung bewertet.

asp-fallback-test

Die im primären Skript definierte Skriptmethode, die für den Fallbacktest verwendet wird. Weitere Informationen finden Sie unter FallbackTestExpression.

asp-order

Wenn eine Reihe von ITagHelper-Instanzen ausgeführt wird, werden ihre Init(TagHelperContext)-Methoden zuerst in der angegebenen Reihenfolge aufgerufen. Anschließend werden ihre ProcessAsync(TagHelperContext, TagHelperOutput)-Methoden in der angegebenen Reihenfolge aufgerufen. Niedrigere Werte werden zuerst ausgeführt.

asp-src-exclude

Eine durch Trennzeichen getrennte Liste mit Globdateimustern von JavaScript-Skripts, die vom Laden ausgeschlossen werden sollen. Die Globmuster werden relativ zur webroot-Einstellung der Anwendung bewertet. Muss zusammen mit asp-src-include verwendet werden.

asp-src-include

Eine durch Trennzeichen getrennte Liste mit Globdateimustern von JavaScript-Skripts, die geladen werden sollen. Die Globmuster werden relativ zur webroot-Einstellung der Anwendung bewertet.

asp-suppress-fallback-integrity

Boolescher Wert, der bestimmt, ob ein Integritätshash mit dem Wert „asp-fallback-src“ verglichen wird.

Zusätzliche Ressourcen