ClientScriptManager.RegisterClientScriptResource(Type, String) Methode

Referenz

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Registriert die Clientskriptressource unter Verwendung eines Typ und eines Ressourcennamens für das Page-Objekt.

public:
 void RegisterClientScriptResource(Type ^ type, System::String ^ resourceName);

public void RegisterClientScriptResource (Type type, string resourceName);

member this.RegisterClientScriptResource : Type * string -> unit

Public Sub RegisterClientScriptResource (type As Type, resourceName As String)

Parameter

type: Type

Der Typ der zu registrierenden Clientskriptressource.

resourceName: String

Der Name der zu registrierenden Clientskriptressource.

Ausnahmen

ArgumentNullException

Der Clientressourcentyp ist null.

- oder -

Der Clientressourcenname ist null.

- oder -

Der Clientressourcenname hat eine Länge von 0 (null).

Beispiele

Im folgenden Codebeispiel wird die Verwendung der RegisterClientScriptResource -Methode veranschaulicht.

<%@ 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>

Im folgenden Codebeispiel wird veranschaulicht, wie das WebResourceAttribute Metadaten-Attribut programmgesteuert angewendet wird, um die Assembly für die bereitgestellten Ressourcen zu markieren.

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

Für dieses Beispiel ist eine JavaScript-Datei mit dem Namen Script_include.jserforderlich, die den folgenden Inhalt enthält:

function DoClick() {Form1.Message.value='Text from resource script.'}

Kompilieren Sie die Script_include.js Datei als Ressource in der Samples.AspNet.CS.Controls Assembly, die die ClientScriptResourceLabel -Klasse enthält.

Hinweise

Die RegisterClientScriptResource -Methode wird verwendet, wenn über den HTTP-Handler WebResource.axd aus Assemblys auf kompilierte Ressourcen zugegriffen wird. Die RegisterClientScriptResource -Methode registriert das Skript beim Page -Objekt und verhindert doppelte Skripts. Diese Methode umschließt den Inhalt der Ressourcen-URL mit einem <script> Elementblock.

Gilt für: