ClientScriptManager Kelas

Referensi

Definisi

Ruang nama:: System.Web.UI

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menentukan metode untuk mengelola skrip klien di aplikasi Web.

public ref class ClientScriptManager sealed

public sealed class ClientScriptManager

type ClientScriptManager = class

Public NotInheritable Class ClientScriptManager

Warisan: Object
ClientScriptManager

Contoh

Contoh kode berikut menunjukkan penggunaan RegisterClientScriptBlock metode ClientScriptManager kelas . Dua skrip klien ditentukan di halaman: PopupScript, yang menampilkan pesan pemberitahuan saat halaman dimuat, dan ButtonClickScript, yang menentukan handler klien untuk peristiwa tombol onClick HTML.

<%@ 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 and type of the client scripts on the page.
    String csname1 = "PopupScript";
    String csname2 = "ButtonClickScript";
    Type cstype = this.GetType();
        
    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;

    // Check to see if the startup script is already registered.
    if (!cs.IsStartupScriptRegistered(cstype, csname1))
    {
      String cstext1 = "alert('Hello World');";
      cs.RegisterStartupScript(cstype, csname1, cstext1, true);
    }

    // Check to see if the client script is already registered.
    if (!cs.IsClientScriptBlockRegistered(cstype, csname2))
    {
      StringBuilder cstext2 = new StringBuilder();
      cstext2.Append("<script type=\"text/javascript\"> function DoClick() {");
      cstext2.Append("Form1.Message.value='Text from client script.'} </");
      cstext2.Append("script>");
      cs.RegisterClientScriptBlock(cstype, csname2, cstext2.ToString(), false);
    }
  }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form id="Form1"
         runat="server">
        <input type="text" id="Message" /> <input type="button" value="ClickMe" onclick="DoClick()" />
     </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 and type of the client scripts on the page.
    Dim csname1 As String = "PopupScript"
    Dim csname2 As String = "ButtonClickScript"
    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 startup script is already registered.
    If (Not cs.IsStartupScriptRegistered(cstype, csname1)) Then
      
      Dim cstext1 As String = "alert('Hello World');"
      cs.RegisterStartupScript(cstype, csname1, cstext1, True)
      
    End If
    
    ' Check to see if the client script is already registered.
    If (Not cs.IsClientScriptBlockRegistered(cstype, csname2)) Then
      
      Dim cstext2 As New StringBuilder()
            cstext2.Append("<script type=""text/javascript""> function DoClick() {")
      cstext2.Append("Form1.Message.value='Text from client script.'} </")
      cstext2.Append("script>")
      cs.RegisterClientScriptBlock(cstype, csname2, cstext2.ToString(), False)
      
    End If
    
  End Sub
  
</script>

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

Keterangan

Kelas ClientScriptManager ini digunakan untuk mengelola skrip klien dan menambahkannya ke aplikasi Web. Anda bisa mendapatkan referensi ke ClientScriptManager kelas dari ClientScript properti Page objek .

Anda dapat menambahkan skrip klien ke halaman Web secara deklaratif dengan menyertakan skrip dalam markup HTML halaman. Namun, ada situasi saat menambahkan skrip klien secara dinamis diperlukan. Untuk menambahkan skrip secara dinamis, gunakan RegisterClientScriptBlock metode , RegisterClientScriptInclude metode , RegisterStartupScript metode , atau RegisterOnSubmitStatement metode , tergantung pada kapan dan bagaimana Anda ingin menambahkan skrip. Untuk informasi selengkapnya, lihat Cara: Menambahkan Skrip Klien Secara Dinamis ke Halaman Web ASP.NET.

Kelas secara ClientScriptManager unik mengidentifikasi skrip dengan kunci String dan Type. Skrip dengan kunci dan jenis yang sama dianggap duplikat. Menggunakan jenis skrip membantu menghindari membingungkan skrip serupa dari kontrol pengguna yang berbeda yang mungkin digunakan di halaman.

Kelas ClientScriptManager dapat digunakan untuk memanggil panggilan balik klien dalam situasi ketika diinginkan untuk menjalankan kode server dari klien tanpa melakukan postback. Ini disebut sebagai melakukan panggilan balik di luar band ke server. Dalam panggilan balik klien, fungsi skrip klien mengirimkan permintaan asinkron ke halaman Web ASP.NET. Halaman Web menjalankan versi yang dimodifikasi dari siklus hidup normalnya untuk memproses panggilan balik. GetCallbackEventReference Gunakan metode untuk mendapatkan referensi ke fungsi klien yang, ketika dipanggil, memulai panggilan balik klien ke peristiwa server. Untuk informasi selengkapnya, lihat Menerapkan Panggilan Balik Klien Tanpa Postback.

Catatan

Panggilan balik skrip tidak akan berfungsi di browser lama yang tidak mendukung Model Objek Dokumen (DOM), dan mereka mengharuskan ECMAScript diaktifkan pada klien. Untuk memeriksa apakah browser mendukung panggilan balik, gunakan SupportsCallback properti , yang dapat diakses melalui Browser properti objek intrinsik Request ASP.NET.

GetPostBackEventReference Gunakan metode dan GetPostBackClientHyperlink metode untuk menentukan peristiwa postback klien. Metode ini memungkinkan fungsi skrip klien, ketika dipanggil, menyebabkan server memposting kembali ke halaman. Peristiwa postback klien berbeda dari panggilan balik klien karena halaman Web menyelesaikan siklus hidup normal untuk memproses peristiwa postback klien.

Catatan

Jika Anda menggunakan Button kontrol dan UseSubmitBehavior properti diatur ke false, maka Anda dapat menggunakan GetPostBackEventReference metode untuk mengembalikan peristiwa postback klien untuk Button kontrol.

OnClientClick Properti kontrolButton, ImageButton kontrol, dan LinkButton kontrol dapat digunakan untuk menjalankan skrip klien.

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetCallbackEventReference(Control, String, String, String)	Mendapatkan referensi ke fungsi klien yang, ketika dipanggil, memulai panggilan klien kembali ke peristiwa server. Fungsi klien untuk metode yang kelebihan beban ini mencakup kontrol, argumen, skrip klien, dan konteks tertentu.
GetCallbackEventReference(Control, String, String, String, Boolean)	Mendapatkan referensi ke fungsi klien yang, ketika dipanggil, memulai panggilan klien kembali ke peristiwa server. Fungsi klien untuk metode kelebihan beban ini mencakup kontrol, argumen, skrip klien, konteks, dan nilai Boolean tertentu.
GetCallbackEventReference(Control, String, String, String, String, Boolean)	Mendapatkan referensi ke fungsi klien yang, ketika dipanggil, memulai panggilan klien kembali ke peristiwa server. Fungsi klien untuk metode kelebihan beban ini mencakup kontrol, argumen, skrip klien, konteks, penangan kesalahan, dan nilai Boolean yang ditentukan.
GetCallbackEventReference(String, String, String, String, String, Boolean)	Mendapatkan referensi ke fungsi klien yang, ketika dipanggil, memulai panggilan klien kembali ke peristiwa server. Fungsi klien untuk metode kelebihan beban ini mencakup target, argumen, skrip klien, konteks, penangan kesalahan, dan nilai Boolean tertentu.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetPostBackClientHyperlink(Control, String)	Mendapatkan referensi, dengan `javascript:` ditambahkan ke awalnya, yang dapat digunakan dalam peristiwa klien untuk memposting kembali ke server untuk kontrol yang ditentukan dan dengan argumen peristiwa yang ditentukan.
GetPostBackClientHyperlink(Control, String, Boolean)	Mendapatkan referensi, dengan `javascript:` ditambahkan ke awalnya, yang dapat digunakan dalam peristiwa klien untuk memposting kembali ke server untuk kontrol yang ditentukan dengan argumen peristiwa yang ditentukan dan indikasi Boolean apakah akan mendaftarkan posting kembali untuk validasi peristiwa.
GetPostBackEventReference(Control, String)	Mengembalikan string yang dapat digunakan dalam peristiwa klien untuk menyebabkan postback ke server. String referensi ditentukan oleh kontrol yang ditentukan yang menangani postback dan argumen string informasi peristiwa tambahan.
GetPostBackEventReference(Control, String, Boolean)	Mengembalikan string yang akan digunakan dalam peristiwa klien untuk menyebabkan postback ke server. String referensi ditentukan oleh kontrol yang ditentukan yang menangani postback dan argumen string informasi peristiwa tambahan. Secara opsional, mendaftarkan referensi peristiwa untuk validasi.
GetPostBackEventReference(PostBackOptions)	Mengembalikan string yang dapat digunakan dalam peristiwa klien untuk menyebabkan postback ke server. String referensi ditentukan oleh instans yang ditentukan PostBackOptions .
GetPostBackEventReference(PostBackOptions, Boolean)	Mengembalikan string yang dapat digunakan dalam peristiwa klien untuk menyebabkan postback ke server. String referensi ditentukan oleh objek yang ditentukan PostBackOptions . Secara opsional, mendaftarkan referensi peristiwa untuk validasi.
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
GetWebResourceUrl(Type, String)	Mendapatkan referensi URL ke sumber daya dalam rakitan.
IsClientScriptBlockRegistered(String)	Menentukan apakah blok skrip klien terdaftar dengan Page objek menggunakan kunci yang ditentukan.
IsClientScriptBlockRegistered(Type, String)	Menentukan apakah blok skrip klien terdaftar dengan Page objek menggunakan kunci dan jenis.
IsClientScriptIncludeRegistered(String)	Menentukan apakah skrip klien yang disertakan terdaftar dengan Page objek menggunakan kunci yang ditentukan.
IsClientScriptIncludeRegistered(Type, String)	Menentukan apakah skrip klien yang disertakan terdaftar dengan Page objek menggunakan kunci dan jenis.
IsOnSubmitStatementRegistered(String)	Menentukan apakah pernyataan OnSubmit terdaftar dengan Page objek menggunakan kunci yang ditentukan.
IsOnSubmitStatementRegistered(Type, String)	Menentukan apakah pernyataan OnSubmit terdaftar dengan Page objek menggunakan kunci dan jenis yang ditentukan.
IsStartupScriptRegistered(String)	Menentukan apakah skrip startup terdaftar dengan Page objek menggunakan kunci yang ditentukan.
IsStartupScriptRegistered(Type, String)	Menentukan apakah skrip startup terdaftar dengan Page objek menggunakan kunci dan jenis yang ditentukan.
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
RegisterArrayDeclaration(String, String)	Mendaftarkan deklarasi array JavaScript dengan Page objek menggunakan nama array dan nilai array.
RegisterClientScriptBlock(Type, String, String)	Mendaftarkan skrip klien dengan Page objek menggunakan jenis, kunci, dan skrip literal.
RegisterClientScriptBlock(Type, String, String, Boolean)	Mendaftarkan skrip klien dengan Page objek menggunakan jenis, kunci, skrip literal, dan nilai Boolean yang menunjukkan apakah akan menambahkan tag skrip.
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 yang disertakan Page dengan objek menggunakan jenis, kunci, dan URL.
RegisterClientScriptResource(Type, String)	Mendaftarkan sumber daya skrip klien dengan Page objek menggunakan jenis dan nama sumber daya.
RegisterExpandoAttribute(String, String, String)	Mendaftarkan pasangan nama/nilai sebagai atribut kustom (expando) dari kontrol yang ditentukan yang diberi ID kontrol, nama atribut, dan nilai atribut.
RegisterExpandoAttribute(String, String, String, Boolean)	Mendaftarkan pasangan nama/nilai sebagai atribut kustom (expando) dari kontrol yang ditentukan yang diberi ID kontrol, nama atribut, nilai atribut, dan nilai Boolean yang menunjukkan apakah akan mengodekan nilai atribut.
RegisterForEventValidation(PostBackOptions)	Mendaftarkan referensi peristiwa untuk validasi dengan PostBackOptions.
RegisterForEventValidation(String)	Mendaftarkan referensi peristiwa untuk validasi dengan ID kontrol unik yang mewakili kontrol klien yang menghasilkan peristiwa.
RegisterForEventValidation(String, String)	Mendaftarkan referensi peristiwa untuk validasi dengan ID kontrol unik dan argumen peristiwa yang mewakili kontrol klien yang menghasilkan peristiwa.
RegisterHiddenField(String, String)	Mendaftarkan nilai tersembunyi dengan Page objek .
RegisterOnSubmitStatement(Type, String, String)	Mendaftarkan pernyataan OnSubmit dengan Page objek menggunakan jenis, kunci, dan literal skrip. Pernyataan dijalankan ketika HtmlForm dikirimkan.
RegisterStartupScript(Type, String, String)	Mendaftarkan skrip startup dengan Page objek menggunakan jenis, kunci, dan literal skrip.
RegisterStartupScript(Type, String, String, Boolean)	Mendaftarkan skrip startup dengan Page objek menggunakan jenis, kunci, skrip literal, dan nilai Boolean yang menunjukkan apakah akan menambahkan tag skrip.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
ValidateEvent(String)	Memvalidasi peristiwa klien yang didaftarkan untuk validasi peristiwa menggunakan metode .RegisterForEventValidation(String)
ValidateEvent(String, String)	Memvalidasi peristiwa klien yang didaftarkan untuk validasi peristiwa menggunakan metode .RegisterForEventValidation(String, String)

Berlaku untuk

Bagikan melalui

ClientScriptManager Kelas

Definisi

Contoh

Keterangan

Metode

Berlaku untuk

Lihat juga

Saran dan Komentar

Sumber Daya Tambahan: