Bagikan melalui

ScriptManager.RegisterClientScriptInclude Metode

Definisi

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

Mendaftarkan file skrip klien dengan ScriptManager kontrol untuk digunakan dengan kontrol yang ada di dalam UpdatePanel kontrol, lalu menambahkan referensi file skrip ke halaman.

Overload

Nama Deskripsi
RegisterClientScriptInclude(Control, Type, String, String)

Mendaftarkan file skrip klien dengan ScriptManager kontrol untuk digunakan dengan kontrol yang ada di dalam UpdatePanel kontrol, lalu menambahkan referensi file skrip ke halaman.
RegisterClientScriptInclude(Page, Type, String, String)

Mendaftarkan skrip klien dengan ScriptManager kontrol setiap kali terjadi postback asinkron, lalu menambahkan referensi file skrip ke halaman.

RegisterClientScriptInclude(Control, Type, String, String)

Mendaftarkan file skrip klien dengan ScriptManager kontrol untuk digunakan dengan kontrol yang ada di dalam UpdatePanel kontrol, lalu menambahkan referensi file skrip ke halaman.

public:
 static void RegisterClientScriptInclude(System::Web::UI::Control ^ control, Type ^ type, System::String ^ key, System::String ^ url);
public static void RegisterClientScriptInclude(System.Web.UI.Control control, Type type, string key, string url);
static member RegisterClientScriptInclude : System.Web.UI.Control * Type * string * string -> unit
Public Shared Sub RegisterClientScriptInclude (control As Control, type As Type, key As String, url As String)

Parameter

control
Control

Kontrol yang mendaftarkan file skrip klien.

type
Type

Jenis file skrip klien. Parameter ini biasanya ditentukan dengan menggunakan operator typeof (C#) atau operator GetType (Visual Basic) untuk mengambil jenis kontrol yang mendaftarkan skrip.

key
String

Pengidentifikasi unik untuk file skrip.

url
String

URL file skrip.

Pengecualian

ArgumentNullException

File type skrip klien adalah null.

-atau-

Kontrol yang mendaftarkan file skrip adalah null.

ArgumentException

Kontrol yang mendaftarkan file skrip tidak ada di pohon kontrol halaman.

-atau-

url adalah null.

-atau-

url kosong.

Contoh

<%@ 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)
    {
        if (!IsPostBack)
            Calendar1.SelectedDate = DateTime.Today;
        
    }
    protected void Page_PreRender(object sender, EventArgs e)
    {
        ScriptManager.RegisterClientScriptInclude(
            this,
            typeof(Page),
            "AlertScript",
            ResolveClientUrl("~/scripts/script_alertdiv.js"));
    }
    protected void IncrementButton_Click(object sender, EventArgs e)
    {
        Calendar1.SelectedDate = Calendar1.SelectedDate.AddDays(1.0);
    }
    protected void DecrementButton_Click(object sender, EventArgs e)
    {
        Calendar1.SelectedDate = Calendar1.SelectedDate.AddDays(-1.0);
    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>ScriptManager RegisterClientScriptInclude</title>
    <style type="text/css">
    div.MessageStyle
    {
      background-color: Green;
      top: 95%;
      left: 1%;
      position: absolute;
      visibility: hidden;
    }
    </style>
</head>
<body>
    <form id="Form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1"
                               runat="server"/>

            <script type="text/javascript">
            Sys.WebForms.PageRequestManager.instance.add_endRequest(Notify);
            </script>

            <asp:UpdatePanel ID="UpdatePanel1" UpdateMode="Conditional"
                runat="server">
                <ContentTemplate>
                    <asp:Calendar ID="Calendar1" runat="server"/>
                    <br />
                    Change the selected date: 
                    <asp:Button runat="server" ID="DecrementButton" Text="-" OnClick="DecrementButton_Click" />
                    <asp:Button runat="server" ID="IncrementButton" Text="+" OnClick="IncrementButton_Click" />
                </ContentTemplate>
            </asp:UpdatePanel>

            <div id="NotifyDiv" class="MessageStyle">
                Updates are complete.
            </div>
        </div>
    </form>
</body>
</html>

function Notify(sender, arg)
{
    ActivateAlertDiv('visible', 'NotifyDiv');
    setTimeout("ActivateAlertDiv('hidden', 'NotifyDiv')", 1000);
}
function ActivateAlertDiv(visstring, elem)
{
    var adiv = document.getElementById(elem);
    adiv.style.visibility = visstring;
}

Keterangan

Anda menggunakan RegisterClientScriptInclude metode untuk mendaftarkan file skrip klien untuk halaman atau bagian dari halaman yang berpartisipasi dalam pembaruan halaman parsial. File skrip klien yang terdaftar dengan menggunakan metode ini dikirim ke halaman hanya ketika control mewakili kontrol yang berada di dalam UpdatePanel kontrol yang sedang diperbarui. Untuk mendaftarkan file skrip setiap kali terjadi postback asinkron, gunakan RegisterClientScriptInclude(Page, Type, String, String) kelebihan metode ini.

Jika Anda ingin mendaftarkan blok skrip yang tidak berkaitan dengan pembaruan halaman parsial, dan jika Anda ingin mendaftarkan blok skrip hanya satu kali selama penyajian halaman awal, gunakan RegisterClientScriptBlock metode ClientScriptManager kelas . Anda bisa mendapatkan referensi ke ClientScriptManager objek dari ClientScript properti halaman.

Metode ini RegisterClientScriptInclude mendaftarkan file skrip klien di halaman dengan merender elemen yang script tag pembukanya berisi src atribut. Parameter url digunakan untuk mengatur src atribut. Untuk mengatasi URL, gunakan ResolveClientUrl metode . Metode ini menggunakan konteks URL yang dipanggil untuk menyelesaikan jalur.

RegisterClientScriptInclude Metode dan RegisterClientScriptResource merender file skrip ke browser. Jika skrip dengan jenis dan kunci yang sama (untuk file skrip) atau jenis dan nama sumber daya yang sama (untuk sumber daya yang disematkan) sudah dirender, skrip tidak dirender lagi.

Lihat juga

Berlaku untuk

RegisterClientScriptInclude(Page, Type, String, String)

Mendaftarkan skrip klien dengan ScriptManager kontrol setiap kali terjadi postback asinkron, lalu menambahkan referensi file skrip ke halaman.

public:
 static void RegisterClientScriptInclude(System::Web::UI::Page ^ page, Type ^ type, System::String ^ key, System::String ^ url);
public static void RegisterClientScriptInclude(System.Web.UI.Page page, Type type, string key, string url);
static member RegisterClientScriptInclude : System.Web.UI.Page * Type * string * string -> unit
Public Shared Sub RegisterClientScriptInclude (page As Page, type As Type, key As String, url As String)

Parameter

page
Page

Objek halaman yang mendaftarkan file skrip klien.

type
Type

Jenis file skrip klien. Parameter ini biasanya ditentukan dengan menggunakan operator typeof (C#) atau operator GetType (Visual Basic) untuk mengambil jenis kontrol yang mendaftarkan skrip.

key
String

Pengidentifikasi unik untuk file skrip.

url
String

URL file skrip.

Pengecualian

ArgumentNullException

File type skrip klien adalah null.

-atau-

Halaman yang mendaftarkan file skrip adalah null.

ArgumentException

url adalah null.

-atau-

url kosong.

Keterangan

Ketika Anda mendaftarkan file skrip dengan metode ini, skrip dirender setiap kali terjadi postback asinkron. Untuk mendaftarkan file skrip untuk kontrol yang berada di dalam UpdatePanel kontrol sehingga skrip didaftarkan hanya ketika UpdatePanel kontrol diperbarui, gunakan RegisterClientScriptInclude(Control, Type, String, String) kelebihan beban metode ini.

Jika Anda ingin mendaftarkan blok skrip yang tidak berkaitan dengan pembaruan halaman parsial, dan jika Anda ingin mendaftarkan blok skrip hanya satu kali selama penyajian halaman awal, gunakan RegisterClientScriptBlock metode ClientScriptManager kelas . Anda bisa mendapatkan referensi ke ClientScriptManager objek dari ClientScript properti halaman.

Lihat juga

Berlaku untuk