ClientScriptManager.RegisterStartupScript Metode

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.

Mendaftarkan skrip startup dengan Page objek .

Overload

Nama	Deskripsi
RegisterStartupScript(Type, String, String)	Mendaftarkan skrip startup dengan Page objek menggunakan jenis, kunci, dan skrip literal.
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.

RegisterStartupScript(Type, String, String)

Mendaftarkan skrip startup dengan Page objek menggunakan jenis, kunci, dan skrip literal.

public:
 void RegisterStartupScript(Type ^ type, System::String ^ key, System::String ^ script);

public void RegisterStartupScript(Type type, string key, string script);

member this.RegisterStartupScript : Type * string * string -> unit

Public Sub RegisterStartupScript (type As Type, key As String, script As String)

Parameter

type: Type

Jenis skrip startup yang akan didaftarkan.

key: String

Kunci skrip startup untuk mendaftar.

script: String

Skrip startup literal untuk didaftarkan.

Contoh

Contoh kode berikut menunjukkan penggunaan RegisterStartupScript metode . Perhatikan bahwa tag skrip awal dan penutupan disertakan dalam script parameter . Untuk menambahkan tag skrip berdasarkan pengaturan parameter tambahan, lihat RegisterStartupScript metode .

<%@ 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";
    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))
    {
        StringBuilder cstext1 = new StringBuilder();
        cstext1.Append("<script type=text/javascript> alert('Hello World!') </");
        cstext1.Append("script>");

        cs.RegisterStartupScript(cstype, csname1, cstext1.ToString());
    }
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>RegisterStartupScript</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    
    </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">
    Public Sub Page_Load(ByVal sender As [Object], ByVal e As EventArgs)
        ' Define the name and type of the client scripts on the page. 
        Dim csname1 As [String] = "PopupScript"
        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 New StringBuilder()
            cstext1.Append("<script type=text/javascript> alert('Hello World!') </")
            cstext1.Append("script>")
        
            cs.RegisterStartupScript(cstype, csname1, cstext1.ToString())
        End If
    End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>RegisterStartupScript</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    
    </div>
    </form>
</body>
</html>

Keterangan

Skrip klien 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.

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

Dalam kelebihan beban RegisterStartupScript metode ini, Anda harus memastikan bahwa skrip yang disediakan dalam parameter dibungkus script dengan <script> blok elemen.

Blok skrip yang ditambahkan oleh RegisterStartupScript metode dijalankan ketika halaman selesai dimuat tetapi sebelum peristiwa halaman OnLoad dinaikkan. Blok skrip tidak dijamin output dalam urutan terdaftar. Jika urutan blok skrip penting, gunakan StringBuilder objek untuk mengumpulkan skrip bersama-sama dalam satu string, lalu daftarkan semuanya dalam satu blok skrip klien.

Lihat juga

RegisterStartupScript(Type, String, String, Boolean)

Berlaku untuk

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.

public:
 void RegisterStartupScript(Type ^ type, System::String ^ key, System::String ^ script, bool addScriptTags);

public void RegisterStartupScript(Type type, string key, string script, bool addScriptTags);

member this.RegisterStartupScript : Type * string * string * bool -> unit

Public Sub RegisterStartupScript (type As Type, key As String, script As String, addScriptTags As Boolean)

Parameter

type: Type

Jenis skrip startup yang akan didaftarkan.

key: String

Kunci skrip startup untuk mendaftar.

script: String

Skrip startup literal untuk didaftarkan.

addScriptTags: Boolean

Nilai Boolean yang menunjukkan apakah akan menambahkan tag skrip.

Pengecualian

ArgumentNullException

type adalah null.

Contoh

Contoh kode berikut menunjukkan penggunaan RegisterStartupScript metode . Perhatikan bahwa addScriptTags parameter diatur ke false sehingga tag skrip awal dan penutupan disertakan dengan script parameter .

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

Skrip startup 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.

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

Dalam kelebihan beban RegisterStartupScript metode ini, Anda dapat menunjukkan apakah skrip yang disediakan dalam parameter dibungkus script dengan <script> blok elemen dengan menggunakan addScriptTags parameter . Pengaturan addScriptTags untuk true menunjukkan bahwa tag skrip akan ditambahkan secara otomatis.

Lihat juga

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?