ClientScriptManager.IsStartupScriptRegistered 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.

Menentukan apakah skrip startup terdaftar dengan Page objek .

Overload

Nama	Deskripsi
IsStartupScriptRegistered(Type, String)	Menentukan apakah skrip startup 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.

public:
 bool IsStartupScriptRegistered(Type ^ type, System::String ^ key);

public bool IsStartupScriptRegistered(Type type, string key);

member this.IsStartupScriptRegistered : Type * string -> bool

Public Function IsStartupScriptRegistered (type As Type, key As String) As Boolean

Parameter

type: Type

Jenis skrip startup yang akan dicari.

key: String

Kunci skrip startup yang akan dicari.

Mengembalikan

Boolean

true jika skrip startup terdaftar; jika tidak, false.

Pengecualian

ArgumentNullException

Jenis skrip startup adalah null.

Contoh

Contoh kode berikut menunjukkan penggunaan IsStartupScriptRegistered metode . Perhatikan bahwa, jika logika untuk memeriksa blok skrip startup yang ada dihapus, tidak akan ada dua skrip startup duplikat dalam kode sumber HTML dari halaman yang dirender karena RegisterStartupScript 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 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

Panggil metode ini sebelum memanggil RegisterStartupScript metode untuk menghindari pendaftaran skrip duplikat. Ini sangat penting jika skrip memerlukan sejumlah besar sumber daya server untuk dibuat.

Skrip startup klien diidentifikasi secara unik oleh kunci dan jenisnya. Skrip dengan kunci dan jenis yang sama dianggap duplikat.

Lihat juga

Berlaku untuk

IsStartupScriptRegistered(String)

Menentukan apakah skrip startup terdaftar dengan Page objek menggunakan kunci yang ditentukan.

public:
 bool IsStartupScriptRegistered(System::String ^ key);

public bool IsStartupScriptRegistered(string key);

member this.IsStartupScriptRegistered : string -> bool

Public Function IsStartupScriptRegistered (key As String) As Boolean

Parameter

key: String

Kunci skrip startup yang akan dicari.

Mengembalikan

Boolean

true jika skrip startup terdaftar; jika tidak, false.

Keterangan

Skrip startup diidentifikasi secara unik oleh kunci dan jenisnya. Skrip dengan kunci dan jenis yang sama dianggap duplikat.

Kelebihan beban IsStartupScriptRegistered metode ini memanggil kelebihan beban yang mengambil string key dan type parameter dengan jenis yang ditetapkan sebagai Page objek

Lihat juga

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?