ClientScriptManager.RegisterClientScriptInclude Metode

Definisi

Ruang nama:
System.Web.UI
Rakitan:
System.Web.dll

Mendaftarkan skrip klien yang disertakan Page dengan objek .

Overload

Nama Deskripsi
RegisterClientScriptInclude(String, String)

Mendaftarkan skrip klien dengan Page objek menggunakan kunci dan URL, yang memungkinkan skrip dipanggil dari klien.
RegisterClientScriptInclude(Type, String, String)

Mendaftarkan skrip klien termasuk dengan Page objek menggunakan jenis, kunci, dan URL.

RegisterClientScriptInclude(String, String)

Mendaftarkan skrip klien dengan Page objek menggunakan kunci dan URL, yang memungkinkan skrip dipanggil dari klien.

public:
 void RegisterClientScriptInclude(System::String ^ key, System::String ^ url);
public void RegisterClientScriptInclude(string key, string url);
member this.RegisterClientScriptInclude : string * string -> unit
Public Sub RegisterClientScriptInclude (key As String, url As String)

Parameter

key
String

Kunci skrip klien termasuk untuk mendaftar.

url
String

URL skrip klien termasuk untuk mendaftar.

Contoh

Untuk informasi terkait, termasuk sintaks, penggunaan, dan contoh, lihat RegisterClientScriptInclude.

Keterangan

Skrip klien termasuk diidentifikasi secara unik oleh kunci dan jenisnya. Skrip dengan kunci dan jenis yang sama dianggap duplikat. Hanya satu skrip dengan jenis dan pasangan kunci tertentu yang dapat didaftarkan ke halaman. Mencoba mendaftarkan skrip yang sudah terdaftar tidak membuat duplikat skrip.

IsClientScriptIncludeRegistered Panggil metode untuk menentukan apakah skrip klien disertakan dengan pasangan kunci dan jenis tertentu sudah terdaftar dan hindari upaya untuk menambahkan skrip yang tidak perlu.

Note

Untuk mengatasi URL klien, gunakan ResolveClientUrl metode . Metode ini menggunakan konteks URL tempat URL dipanggil untuk menyelesaikan jalur.

Kelebihan metode RegisterClientScriptInclude ini memanggil kelebihan beban yang mengambil keyparameter , URL, dan .type

Metode menambahkan blok skrip di bagian atas halaman yang dirender.

Lihat juga

Berlaku untuk

RegisterClientScriptInclude(Type, String, String)

Mendaftarkan skrip klien termasuk dengan Page objek menggunakan jenis, kunci, dan URL.

public:
 void RegisterClientScriptInclude(Type ^ type, System::String ^ key, System::String ^ url);
public void RegisterClientScriptInclude(Type type, string key, string url);
member this.RegisterClientScriptInclude : Type * string * string -> unit
Public Sub RegisterClientScriptInclude (type As Type, key As String, url As String)

Parameter

type
Type

Jenis skrip klien termasuk untuk mendaftar.

key
String

Kunci skrip klien termasuk untuk mendaftar.

url
String

URL skrip klien termasuk untuk mendaftar.

Pengecualian

ArgumentNullException

Jenis skrip klien termasuk adalah null.

ArgumentException

URL-nya adalah null.

-atau-

URL kosong.

Contoh

Contoh kode berikut menunjukkan penggunaan RegisterClientScriptInclude metode . Perhatikan bahwa jika logika untuk memeriksa skrip klien yang ada termasuk dihapus, masih tidak akan ada skrip klien duplikat di halaman yang dirender karena RegisterClientScriptInclude metode memeriksa duplikat. Manfaat pemeriksaan adalah mengurangi komputasi yang tidak perlu.

<%@ Page Language="C#"%>

<!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 name, type and url of the client script on the page.
        String csname = "ButtonClickScript";
        String csurl = "~/script_include.js";
        Type cstype = this.GetType();

        // Get a ClientScriptManager reference from the Page class.
        ClientScriptManager cs = Page.ClientScript;

        // Check to see if the include script exists already.
        if (!cs.IsClientScriptIncludeRegistered(cstype, csname))
        {
            cs.RegisterClientScriptInclude(cstype, csname, ResolveClientUrl(csurl));
        }

    }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form id="Form1" runat="server">
     <div>
        <input type="text"
               id="Message"/> 
        <input type="button" 
               value="ClickMe"
               onclick="DoClick()"/>
     </div>
     </form>
  </body>
</html>

<%@ Page Language="VB" %>

<!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 name, type and url of the client script on the page.
        Dim csname As String = "ButtonClickScript"
        Dim csurl As String = "~/script_include.js"
        Dim cstype As Type = Me.GetType()
    
        ' Get a ClientScriptManager reference from the Page class.
        Dim cs As ClientScriptManager = Page.ClientScript
    
        ' Check to see if the include script is already registered.
        If (Not cs.IsClientScriptIncludeRegistered(cstype, csname)) Then
      
            cs.RegisterClientScriptInclude(cstype, csname, ResolveClientUrl(csurl))
      
        End If
    
    End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ClientScriptManager Example</title>
</head>
<body>
     <form id="Form1" runat="server">
     <div>
        <input type="text"
               id="Message"/> 
        <input type="button" 
               value="ClickMe"
               onclick="DoClick()"/>
     </div>
     </form>
</body>
</html>

Contoh ini memerlukan file JavaScript bernama Script_include.js dengan konten berikut:

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

Keterangan

Kelebihan metode RegisterClientScriptInclude ini mengambil parameter kunci dan url untuk mengidentifikasi skrip, serta type parameter untuk menentukan identifikasi skrip klien termasuk. Anda menentukan jenis berdasarkan objek yang akan mengakses sumber daya. Misalnya, saat menggunakan Page instans untuk mengakses sumber daya, Anda menentukan jenisnya Page .

Note

Untuk mengatasi URL klien, gunakan ResolveClientUrl metode . Metode ini menggunakan konteks URL tempat URL dipanggil untuk menyelesaikan jalur.

Metode ini menambahkan blok skrip di bagian atas halaman yang dirender.

Lihat juga

Berlaku untuk