ClientScriptManager.RegisterClientScriptResource(Type, String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
型とリソース名を使用して、クライアント スクリプト リソースを Page オブジェクトに登録します。
public:
void RegisterClientScriptResource(Type ^ type, System::String ^ resourceName);public void RegisterClientScriptResource (Type type, string resourceName);member this.RegisterClientScriptResource : Type * string -> unitPublic Sub RegisterClientScriptResource (type As Type, resourceName As String)パラメーター
- type
- Type
登録するクライアント スクリプト リソースの型。
- resourceName
- String
登録するクライアント スクリプト リソースの名前。
例外
クライアント リソースの型が null です。
- または -
クライアント リソースの名前が null です。
- または - クライアント リソースの名前の長さがゼロです。
例
次のコード例では、このメソッドの使用方法を RegisterClientScriptResource 示します。
<%@ Page Language="C#"%>
<%@ Import Namespace="Samples.AspNet.CS.Controls" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
public void Page_Load(Object sender, EventArgs e)
{
// Define the resource name and type.
String rsname = "Samples.AspNet.CS.Controls.script_include.js";
Type rstype = typeof(ClientScriptResourceLabel);
// Get a ClientScriptManager reference from the Page class.
ClientScriptManager cs = Page.ClientScript;
// Write out the web resource url.
ResourcePath.InnerHtml = cs.GetWebResourceUrl(rstype, rsname);
// Register the client resource with the page.
cs.RegisterClientScriptResource(rstype, rsname);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ClientScriptManager Example</title>
</head>
<body>
<form id="Form1"
runat="server">
The web resource path is
<span id="ResourcePath"
runat="server"/>.
<br />
<br />
<input type="text"
id="Message" />
<input type="button"
onclick="DoClick()"
value="ClientClick" />
</form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ Import Namespace="Samples.AspNet.VB.Controls" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
' Define the resource name and type.
Dim rsname As String = "Samples.AspNet.VB.Controls.script_include.js"
Dim rstype As Type = GetType(ClientScriptResourceLabel)
' Get a ClientScriptManager reference from the Page class.
Dim cs As ClientScriptManager = Page.ClientScript
' Write out the web resource url.
ResourcePath.InnerHtml = cs.GetWebResourceUrl(rstype, rsname)
' Register the client resource with the page.
cs.RegisterClientScriptResource(rstype, rsname)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ClientScriptManager Example</title>
</head>
<body>
<form id="Form1"
runat="server">
The web resource path is
<span id="ResourcePath"
runat="server"/>.
<br />
<br />
<input type="text"
id="Message" />
<input type="button"
onclick="DoClick()"
value="ClientClick" />
</form>
</body>
</html>
次のコード例は、プログラムによってメタデータ属性を WebResourceAttribute 適用して、提供されるリソースのアセンブリをマークする方法を示しています。
using System;
using System.Web;
using System.Web.UI;
using System.Security.Permissions;
[assembly: WebResource("Samples.AspNet.CS.Controls.script_include.js", "application/x-javascript")]
namespace Samples.AspNet.CS.Controls
{
[AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal)]
public class ClientScriptResourceLabel
{
// Class code goes here.
}
}
Imports System.Web
Imports System.Web.UI
Imports System.Security.Permissions
<Assembly: WebResource("Samples.AspNet.VB.Controls.script_include.js", "application/x-javascript")>
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
Public Class ClientScriptResourceLabel
' Class code goes here.
End Class
End Namespace
この例では、次の内容を含む JavaScript ファイルが Script_include.js必要です。
function DoClick() {Form1.Message.value='Text from resource script.'}
クラスを Script_include.js 含むアセンブリ内の Samples.AspNet.CS.Controls リソースとしてファイルを ClientScriptResourceLabel コンパイルします。
注釈
このメソッドは RegisterClientScriptResource 、WebResource.axd HTTP ハンドラーを介してアセンブリからコンパイルされたリソースにアクセスするときに使用されます。 このメソッドは RegisterClientScriptResource 、スクリプトをオブジェクトに Page 登録し、スクリプトの重複を防ぎます。 このメソッドは、リソース URL の内容を要素ブロックで <script> ラップします。