JavaScript IntelliSense

Anstatt das gesamte Clientskript auf einer Seite zu schreiben, können Sie auf externe Dateien verweisen, die Skriptcode enthalten. Auf diese Weise können Sie Code einfach seitenübergreifend wiederverwenden, und das Clientskript kann vom Browser zwischengespeichert werden.

Wenn Sie keine ASP.NET-AJAX-fähige Webseite verwenden, können Sie mit dem src-Attribut im Starttag eines script-Elements auf externe Skriptdateien verweisen. Das src-Attribut gibt die URL zu einer externen Datei an, die den Quellcode oder die Daten enthält.

Das folgende Beispiel enthält Markup, das das src-Attribut in einem <script>-Tag zum Verweisen auf eine Skriptdatei verwendet.

<script type="text/javascript" src="~/Scripts/JavaScript.js">
  
</script>

Bei Verwendung einer ASP.NET-AJAX-fähigen Webseite können Sie mithilfe des ScriptReference-Objekts des ScriptManager-Steuerelements auf Skriptdateien verweisen.

Das folgende Beispiel enthält Markup, das ein ScriptReference-Objekt in einem ScriptManager-Steuerelement zum Verweisen auf eine Skriptdatei verwendet.

<asp:ScriptManager ID="ScriptManager1" runat="server">
  <Scripts>
    <asp:ScriptReference Path="~/Scripts/JavaScript.js" />
  </Scripts>
</asp:ScriptManager>

IntelliSense bietet zusätzlich Unterstützung für Skriptdateien, die als Ressourcen in einer Assembly in ASP.NET-AJAX-Webanwendungen eingebettet sind. Weitere Informationen zu eingebetteten Skriptressourcen finden Sie unter Embedding a JavaScript File as a Resource in an Assembly.

Mithilfe einer reference-Direktive kann Visual Studio eine Beziehung zwischen dem gerade von Ihnen bearbeiteten und anderen Skripts herstellen. Die reference-Direktive bietet Ihnen die Möglichkeit, eine Skriptdatei in den Skriptkontext der aktuellen Skriptdatei einzubeziehen. Dadurch kann IntelliSense auf extern definierte Funktionen, Typen und Felder verweisen, während Sie den Code erstellen.

Sie erstellen eine reference-Direktive in Form eines XML-Kommentars. Die Direktive muss in der Datei vor allen möglichen Skripts deklariert werden. Eine reference-Direktive kann Skriptverweise enthalten, die auf Datenträgern, Assemblys, Diensten oder Seiten basieren.

Im Folgenden wird anhand verschiedener Beispiele die Verwendung datenträgerbasierter Reference-Direktiven veranschaulicht. Im ersten Beispiel sucht der Sprachdienst nach der Datei im gleichen Ordner, der die Projektdatei enthält (beispielsweise, .jsproj).

/// <reference path="ScriptFile1.js" />

/// <reference path="Scripts/ScriptFile2.js" />

/// <reference path="../ScriptFile3.js" />

/// <reference path="~/Scripts/ScriptFile4.js" />

Das folgende Beispiel zeigt, wie ein Verweis auf ein assemblybasiertes Skript erstellt wird.

/// <reference name "Ajax.js" assembly="System.Web.Extensions, ..." />

Das folgende Beispiel zeigt, wie auf ein dienstbasiertes Skript verwiesen wird:

/// <reference path="MyService.asmx" />

/// <reference path="Services/MyService.asmx" />

/// <reference path="../MyService.asmx" />

/// <reference path="~/Services/MyService.asmx" />

Hinweis
JavaScript JScript-IntelliSense nicht für Skript unterstützt, die in den Dateien des Webdiensts (.asmx) in Webanwendungsprojekten (WAP) wird.

Das folgende Beispiel zeigt, wie auf ein seitenbasiertes Skript verwiesen wird.

/// <reference path="Default.aspx" />

/// <reference path="Admin/Default.aspx" />

/// <reference path="../Default.aspx" />

/// <reference path="~/Admin/Default.aspx" />

Die folgenden Regeln beziehen sich auf eine reference-Direktive.

• Der reference-XML-Kommentar muss vor allen möglichen Skripts deklariert werden.

• Es muss XML-Kommentarsyntax mit drei Schrägstrichen verwendet werden. Verweise, die unter Verwendung der standardmäßigen Kommentarsyntax (zwei Schrägstriche) erstellt wurden, werden ignoriert.

• Pro Direktive kann nur eine Datei oder Ressource angegeben werden.

• Mehrere Verweise auf seitenbasierte Skripts sind nicht zulässig.

• Wenn ein Seitenverweis angegeben wird, ist kein anderer Reference-Direktiventyp zulässig.

• Dateinamen verwenden relative Pfade. Sie können den Tildeoperator (~) verwenden, um Pfade relativ zum Stammverzeichnis der Anwendung anzugeben.

• Absolute Pfade werden ignoriert.

• Reference-Direktiven in Seiten, auf die verwiesen wird, werden nicht verarbeitet. Dies bedeutet, dass Reference-Direktiven für Seiten nicht rekursiv aufgelöst werden. Es wird nur Skriptcode berücksichtigt, auf den direkt von der Seite verwiesen wird.

Sie können Vergleichsgruppen verwenden, um anzugeben, dass bestimmte Dateien IntelliSense .js im Bereich für all JavaScript-Projekte sind. Drei Vergleichsgruppen sind verfügbar: Implizite (Windows), implizite (Internet) und dedizierte Workervergleichsgruppen. Implizite (Windows-) Verweise sind für Windows Store-App mit JavaScript, und implizite (Internet-) Verweise sind für Projekte HTML5. Die Dateien, die in diesen impliziten Vergleichsgruppen enthalten sind, im Bereich für jede JS-Datei, die im Code-Editor geöffnet ist.

Die dedizierte Workervergleichsgruppe ist für Worker des Internet-HTML5. Die Dateien, die in dieser Gruppe angegeben werden, sind im Bereich für JS-Dateien, die einen expliziten Verweis auf einer dedizierten Workervergleichsgruppe haben. Implizite Verweise gelten nicht für JS-Dateien zu, die einen expliziten Verweis auf einer dedizierten Workervergleichsgruppe haben.

Sie können Konfigurationsoptionen verwenden, sodass der JavaScript-Code-Editor implizite Verweise angibt. Weitere Informationen finden Sie unter Optionen, Text-Editor, JavaScript, IntelliSense.

Tipp
Die IntelliSense-Verweise werden in der Regel verwendet, um IntelliSense-Unterstützung für globale Objekte und für IntelliSense Erweiterungen zu unterstützen. Sie können diese Funktion für Skripts auch verwenden, die mithilfe des Skriptladeprogramms zur Laufzeit geladen werden müssen.