ClientScriptManager.IsStartupScriptRegistered Yöntem

Tanım

Ad Alanı:
System.Web.UI
Bütünleştirilmiş Kod:
System.Web.dll

Başlangıç betiğinin nesnesine Page kaydedilip kaydedilmediğini belirler.

Aşırı Yüklemeler

Name Description
IsStartupScriptRegistered(Type, String)

Başlangıç betiğinin belirtilen anahtar ve tür kullanılarak nesneye Page kaydedilip kaydedilmediğini belirler.
IsStartupScriptRegistered(String)

Başlangıç betiğinin belirtilen anahtarı kullanarak nesneye Page kaydedilip kaydedilmediğini belirler.

IsStartupScriptRegistered(Type, String)

Başlangıç betiğinin belirtilen anahtar ve tür kullanılarak nesneye Page kaydedilip kaydedilmediğini belirler.

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

Parametreler

type
Type

Aranacak başlangıç betiğinin türü.

key
String

Aranacak başlangıç betiğinin anahtarı.

Döndürülenler

Boolean

true başlangıç betiği kayıtlıysa; aksi takdirde , false.

Özel durumlar

ArgumentNullException

Başlangıç betiği türü şeklindedir null.

Örnekler

Aşağıdaki kod örneği, yönteminin IsStartupScriptRegistered kullanımını gösterir. Mevcut başlangıç betiği bloğunu denetleme mantığı kaldırılırsa, yöntem yinelenenleri denetlediğinden RegisterStartupScript işlenen sayfanın HTML kaynak kodunda iki yinelenen başlangıç betiği bulunmayacağını unutmayın. Denetimin avantajı, gereksiz hesaplamaları azaltmaktır.

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

Açıklamalar

Yinelenen betiklerin kaydedilmesini RegisterStartupScript önlemek için yöntemini çağırmadan önce bu yöntemi çağırın. Betiğin oluşturulması için çok fazla sayıda sunucu kaynağı gerekiyorsa bu özellikle önemlidir.

İstemci başlangıç betiği, anahtarı ve türüyle benzersiz olarak tanımlanır. Aynı anahtara ve türe sahip betikler yinelenen olarak kabul edilir.

Ayrıca bkz.

Şunlara uygulanır

IsStartupScriptRegistered(String)

Başlangıç betiğinin belirtilen anahtarı kullanarak nesneye Page kaydedilip kaydedilmediğini belirler.

public:
 bool IsStartupScriptRegistered(System::String ^ key);
public bool IsStartupScriptRegistered(string key);
member this.IsStartupScriptRegistered : string -> bool
Public Function IsStartupScriptRegistered (key As String) As Boolean

Parametreler

key
String

Aranacak başlangıç betiğinin anahtarı.

Döndürülenler

Boolean

true başlangıç betiği kayıtlıysa; aksi takdirde , false.

Açıklamalar

Yinelenen betiklerin kaydedilmesini RegisterStartupScript önlemek için yöntemini çağırmadan önce bu yöntemi çağırın. Betiğin oluşturulması için çok fazla sayıda sunucu kaynağı gerekiyorsa bu özellikle önemlidir.

Başlangıç betiği, anahtarı ve türüyle benzersiz olarak tanımlanır. Aynı anahtara ve türe sahip betikler yinelenen olarak kabul edilir.

Yönteminin IsStartupScriptRegistered bu aşırı yüklemesi, türü nesne olarak key ayarlanan bir dizeyi type ve Page parametreyi alan aşırı yüklemeyi çağırır

Ayrıca bkz.

Şunlara uygulanır