JScript IntelliSense では、現在のプログラミング コンテキストに関連するすべてのスクリプトに基づいて、入力するコードを選択できます。これには、現在のファイル内のスクリプト要素が含まれます。また、スクリプト ファイル参照、アセンブリ スクリプト参照、サービス参照、ページに関連付けられた参照など、作業中のスクリプトから直接的または間接的に参照されるコードもすべて含まれます。

現在のプログラミング コンテキストは、次の項目に基づいて作成されます。

• 現在のスクリプト ブロックに定義されている関数。ファイル名拡張子が .aspx、.ascx、.master、.html、および .htm のファイルでは、インライン スクリプト ブロックがサポートされています。

• スクリプト ファイルを指定する src 属性が含まれた各 script 要素。参照先スクリプト ファイルのファイル名拡張子は .js であることが必要です。

• references ディレクティブを使用して別の JScript ファイルを参照している JScript ファイル。

• XML Web サービスへの参照。

• Web アプリケーションが ASP.NET AJAX アプリケーションの場合は、ScriptManager コントロールおよび ScriptManagerProxy コントロール。

• AJAX 対応の ASP.NET Web アプリケーションの作業をしている場合は、Microsoft AJAX Library。

  メモ :
  IntelliSense は、HTML 要素のイベント ハンドラ属性内のスクリプトや href 属性に定義されたスクリプトではサポートされません。

JScript IntelliSense を使用できるようにするため、Visual Studio では次の操作が実行されます。

• アクティブ ドキュメント内の参照と、参照されるファイル内のスクリプト参照を再帰的にチェックする処理に基づいて JScript 依存ファイルのリストを作成します。

• リストを走査し、各ファイルから型情報やその他の関連データを収集します。

• データを集計して JScript エンジンに渡します。これにより、型情報やデータが IntelliSense で使用できるようになります。

• ファイルで IntelliSense のリストに影響する可能性がある変更を監視し、必要に応じてリストを更新します。

ページのトップへ

JScript IntelliSense では、body、form、div などのダイナミック HTML (DHTML: Dynamic HTML) DOM 要素のプログラミングで参照できる一覧が表示されます。現在のドキュメントとマスタ ページに含まれる要素だけが IntelliSense によって表示されます。window オブジェクトと document オブジェクト、およびそれらのメンバも JScript IntelliSense でサポートされます。

JScript IntelliSense では、ネイティブな組み込みオブジェクトのプログラミングで参照できる一覧が表示されます。これには、Array、String、Math、Date、および Number があります。組み込みオブジェクトの詳細については、「組み込みオブジェクト」を参照してください。

JScript ファイルを変更すると、開かれているドキュメントと参照されているドキュメントが Visual Studio でスキャンされ、利用できるすべてのコード リソースが確認されます。これには、ユーザーが作成した変数、関数、およびオブジェクトが含まれます。その後、これらのリソースが JScript IntelliSense で利用できるようになります。 

ユーザー定義の変数、関数、およびオブジェクトの詳細については、MSDN Web サイトの「Creating Your Own Objects」を参照してください。

ページ内にすべてのクライアント スクリプトを記述する代わりに、スクリプト コードを格納した外部ファイルを参照できます。これによって、ページ間でのコードの再利用が容易になり、ブラウザでクライアント スクリプトをキャッシュできるようになります。

ASP.NET AJAX 対応の Web ページで作業している場合は、ScriptManager コントロールの ScriptReference オブジェクトを使用してスクリプト ファイルを参照できます。

ScriptManager コントロールの ScriptReference オブジェクトを使用してスクリプト ファイルを参照するマークアップの例を次に示します。

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

ASP.NET AJAX 対応の Web ページで作業していない場合は、script 要素の開始タグにある src 属性を使用して外部スクリプト ファイルを参照できます。src 属性には、ソース コードまたはデータを格納した外部ファイルへの URL が指定されます。

script タグの src 属性を使用してスクリプト ファイルを参照するマークアップの例を次に示します。

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

IntelliSense では、ASP.NET AJAX Web アプリケーションのアセンブリ内にリソースとして埋め込まれるスクリプト ファイルもサポートされます。埋め込みスクリプト リソースの詳細については、「チュートリアル : アセンブリ内のリソースとしての JavaScript ファイルの埋め込み」を参照してください。

参照ディレクティブ

references ディレクティブを使用すると、現在編集中のスクリプトとその他のスクリプトとの間の関係を Visual Studio で確立できます。references ディレクティブにより、現在のスクリプト ファイル内のスクリプトのコンテキストにスクリプト ファイルを含めることができます。これにより、コードの入力時に、外部で定義されている関数、型、およびフィールドを IntelliSense で参照できます。 

references ディレクティブは、XML コメントの形式で作成します。このディレクティブは、ファイル内で他のいずれのスクリプトよりも前に定義する必要があります。reference ディレクティブには、ディスク ベースのスクリプト参照、アセンブリ ベースのスクリプト参照、サービス ベースのスクリプト参照、またはページ ベースのスクリプト参照を含めることができます。

ディスク ベースの参照ディレクティブを使用する例を次に示します。

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

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

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

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

アセンブリ ベースのスクリプトへの参照を作成する方法の例を次に示します。

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

サービス ベースのスクリプトへの参照方法の例を次に示します。

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

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

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

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

メモ :
JScript IntelliSense は、Web アプリケーション プロジェクト (WAP: Web Application Project) の Web サービス ファイル (.asmx) 内に格納されたスクリプトではサポートされません。

ページ ベースのスクリプトへの参照方法の例を次に示します。

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

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

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

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

reference ディレクティブには、次の規則が適用されます。

• reference XML コメントは、他のいずれのスクリプトよりも前に定義する必要があります。

• XML コメントの構文を 3 つのスラッシュと共に使用する必要があります。標準のコメントの構文 (2 つのスラッシュ) を使用して作成された参照は無視されます。

• ディレクティブごとに、1 つのファイルまたは 1 つのリソースだけを指定できます。

• ページ ベースのスクリプトへの複数の参照は指定できません。

• ページ参照を指定する場合、これ以外の種類の参照ディレクティブは指定できません。

• ファイル名には相対パスを使用します。ティルダ演算子 (~) を使用すると、アプリケーション ルートに対する相対パスを指定できます。

• 絶対パスは無視されます。

• 現在のプロジェクトの外部にあるファイルへの参照は無視されます。

• 参照されるページにある参照ディレクティブは処理されません。つまり、参照ディレクティブは、ページに対して再帰的には解決されません。ページによって直接参照されるスクリプトだけが含まれます。

XML コード コメントは、スクリプトに追加される説明テキストです。これらの説明テキストは、コメントされたスクリプトを参照したときに IntelliSense で表示されます。XML コード コメントは、参照されるファイル、アセンブリ、およびサービスでのみ使用できます。

XML コード コメントを指定すると、概要に加えてパラメータや関数の戻り値に関する情報を示すことができます。XML コード コメントを使用したスクリプトの例を次に示します。

function areaFunction(radiusParam)
{
    /// <summary>Determines the area of a cicle based on a radius parameter.</summary>
    /// <param name="radius" type="Number">The radius of the circle.</param>
    /// <returns type="Number">Returns a number that represents the area.</returns>
    var areaVal;
    areaVal = Math.PI * radiusParam * radiusParam;
    return areaVal;
}

IntelliSense では、次のファイル参照が使用されているときに XML コメントのコード参照を表示できます。

• .js ファイルを参照する .aspx ファイル。

• 別の .js ファイルを参照する .js ファイル。

• .aspx ファイルを参照する .js ファイル。

いずれかの .aspx ファイルで別の .aspx ファイルを参照している場合、IntelliSense は使用できません。

XML コード コメントを追加して JScript IntelliSense を利用できるようにする方法の詳細については、「チュートリアル : JScript IntelliSense」を参照してください。

ASP.NET AJAX も JScript IntelliSense をサポートしています。ASP.NET AJAX には、ECMAScript (JavaScript および JScript) で使用できる標準の型を拡張するクライアント フレームワークが含まれています。JScript IntelliSense を有効にして ASP.NET AJAX オブジェクトに関する詳細を利用できるようにするために、XML コード コメントが Microsoft AJAX Library 全体に追加されました。これらの XML コード コメントは、ASP.NET AJAX ライブラリに格納された型およびメンバを使用したときに表示されます。

メモ :
プライベート メンバは JScript IntelliSense では表示されません。プライベート メンバは、ASP.NET AJAX ではアンダースコア (_) で始まるメンバとして表されます。

Visual Studio では、JScript IntelliSense の検証が次の 2 つの方法で呼び出されます。

• アイドル時の呼び出し。検証は、スクリプトを含むアクティブ ドキュメントのアイドル時に自動的に呼び出されます。

• 手動による呼び出し。JScript IntelliSense の検証は、手動でも呼び出すことができます。これを行うには、[編集] メニューの [詳細] をポイントし、[ドキュメントの検証] をクリックします。このコマンドは、開いているすべてのドキュメントに適用されます。

Visual Studio がスクリプト参照を解決できない場合、または他の種類のスクリプト エラーのために IntelliSense エンジンが現在のスクリプトのコンテキストから完全な結果を収集できない場合は、次の方法で Visual Studio によりフィードバックが作成されます。

• エディタ内の下線付き要素。赤い波型の下線はエラーを示します。マウス ポインタをエラーの上に置くと、ツールヒントにエラーの説明が表示されます。

• [エラー一覧] ウィンドウ。[エラー一覧] ウィンドウに、エラーの説明、エラーが発生したファイル、行番号と列番号、およびプロジェクトが表示されます。[エラー一覧] ウィンドウを表示するには、[表示] メニューの [エラー一覧] をクリックします。

ページのトップへ