Aracılığıyla paylaş

ClientScriptManager.IsClientScriptBlockRegistered Yöntem

  • Başvuru

Tanım

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

İstemci betik bloğunun nesneye Page kaydedilip kaydedilmediğini belirler.

Aşırı Yüklemeler

IsClientScriptBlockRegistered(String)

İstemci betik bloğunun belirtilen anahtarı kullanarak nesneye Page kaydedilip kaydedilmediğini belirler.
IsClientScriptBlockRegistered(Type, String)

İstemci betik bloğunun bir anahtar ve tür kullanarak nesneye Page kaydedilip kaydedilmediğini belirler.

IsClientScriptBlockRegistered(String)

İstemci betik bloğunun belirtilen anahtarı kullanarak nesneye Page kaydedilip kaydedilmediğini belirler.

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

Parametreler

key
String

Aranacak istemci betik bloğunun anahtarı.

Döndürülenler

Boolean

true istemci betik bloğu kayıtlıysa; aksi takdirde , false.

Örnekler

<%@ 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);
    }

    // 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());
    }
  }
</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)
      
    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())
      
    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 RegisterClientScriptBlock önlemek için yöntemini çağırmadan önce bu yöntemi çağırın. Betiğin oluşturulması için çok fazla miktarda sunucu kaynağı gerekiyorsa bu özellikle önemlidir.

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

Yöntemin IsClientScriptBlockRegistered bu aşırı yüklemesi, hem hem key de türü nesne olarak Page ayarlanmış bir type parametre alan aşırı yüklemeyi çağırır

Ayrıca bkz.

Şunlara uygulanır

IsClientScriptBlockRegistered(Type, String)

İstemci betik bloğunun bir anahtar ve tür kullanarak nesneye Page kaydedilip kaydedilmediğini belirler.

public:
 bool IsClientScriptBlockRegistered(Type ^ type, System::String ^ key);
public bool IsClientScriptBlockRegistered (Type type, string key);
member this.IsClientScriptBlockRegistered : Type * string -> bool
Public Function IsClientScriptBlockRegistered (type As Type, key As String) As Boolean

Parametreler

type
Type

Aranacak istemci betik bloğunun türü.

key
String

Aranacak istemci betik bloğunun anahtarı.

Döndürülenler

Boolean

true istemci betik bloğu kayıtlıysa; aksi takdirde , false.

Özel durumlar

ArgumentNullException

İstemci betik türü şeklindedir null.

Örnekler

Aşağıdaki kod örneği yönteminin IsClientScriptBlockRegistered kullanımını gösterir. Mevcut istemci betik bloğunu denetleme mantığı kaldırılırsa, yöntem yinelenenleri denetlediğinden, işlenen sayfanın RegisterClientScriptBlock HTML kaynak kodunda iki yinelenen istemci betiği olmayacağını unutmayın. Denetlemenin 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 RegisterClientScriptBlock önlemek için yöntemini çağırmadan önce bu yöntemi çağırın. Betiğin oluşturulması için çok fazla miktarda sunucu kaynağı gerekiyorsa bu özellikle önemlidir.

İstemci betiği, anahtarı ve türüyle benzersiz bir şekilde tanımlanır. Aynı anahtara ve türe sahip betikler yinelenen olarak kabul edilir. Türü kaynağa erişecek nesneye göre belirtirsiniz. Örneğin, kaynağa erişmek için bir Page örnek kullanırken türünü belirtirsiniz Page .

Ayrıca bkz.

Şunlara uygulanır