ClientScriptManager.RegisterClientScriptBlock Yöntem

Tanım

Ad Alanı:: System.Web.UI

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

İstemci betiğini nesnesine Page kaydeder.

Aşırı Yüklemeler

Name	Description
RegisterClientScriptBlock(Type, String, String)	Bir tür, anahtar ve betik değişmez değeri kullanarak istemci betiğini nesnesine Page kaydeder.
RegisterClientScriptBlock(Type, String, String, Boolean)	betik etiketleri eklenip eklenmeyeceğini Page belirten bir tür, anahtar, betik değişmez değeri ve Boole değeri kullanarak istemci betiğini nesnesine kaydeder.

RegisterClientScriptBlock(Type, String, String)

Bir tür, anahtar ve betik değişmez değeri kullanarak istemci betiğini nesnesine Page kaydeder.

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

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

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

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

Parametreler

type: Type

Kaydedilecek istemci betiğinin türü.

key: String

Kaydedilecek istemci betiğinin anahtarı.

script: String

Kaydedilecek istemci betiği değişmez değeri.

Örnekler

Aşağıdaki kod örneği, yönteminin RegisterClientScriptBlock kullanımını gösterir.

<%@ 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 script on the page.
    String csName = "ButtonClickScript";
    Type csType = this.GetType();

    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;

    // Check to see if the client script is already registered.
    if (!cs.IsClientScriptBlockRegistered(csType, csName))
    {
      StringBuilder csText = new StringBuilder();
      csText.Append("<script type=\"text/javascript\"> function DoClick() {");
      csText.Append("Form1.Message.value='Text from client script.'; }");
      csText.Append("</script>");
      cs.RegisterClientScriptBlock(csType, csName, csText.ToString());
    }
  }
</script>
<html  >
  <head>
    <title>RegisterClientScriptBlock 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">
    Public Sub Page_Load(ByVal sender As [Object], ByVal e As EventArgs)
        ' Define the name and type of the client script on the page. 
        Dim csName 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 client script is already registered. 
        If Not cs.IsClientScriptBlockRegistered(csType, csName) Then
            Dim csText As New StringBuilder()
            csText.Append("<script type=""text/javascript""> function DoClick() {")
            csText.Append("Form1.Message.value='Text from client script.'; }")
            csText.Append("</script>")
            cs.RegisterClientScriptBlock(csType, csName, csText.ToString())
        End If
    End Sub
</script>
<html  >
  <head>
    <title>RegisterClientScriptBlock 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

İstemci betiği, anahtarı ve türüyle benzersiz olarak tanımlanır. Aynı anahtara ve türe sahip betikler yinelenen olarak kabul edilir. Belirli bir türe ve anahtar çifte sahip yalnızca bir betik sayfaya kaydedilebilir. Zaten kayıtlı olan bir betiği kaydetmeye çalışmak, betiğin bir kopyasını oluşturmaz.

IsClientScriptBlockRegistered Belirli bir anahtar ve tür çiftine sahip bir istemci betiğinin zaten kayıtlı olup olmadığını belirlemek ve gereksiz yere betiği eklemeye çalışmaktan kaçınmak için yöntemini çağırın.

yönteminin RegisterClientScriptBlock bu aşırı yüklemesinde, parametresinde sağlanan betiğin bir script öğe bloğunda sarmalandığından <script> emin olmanız gerekir.

yöntemi, RegisterClientScriptBlock işlenen sayfanın en üstüne bir betik bloğu ekler. Betik bloklarının kayıtlı oldukları sırayla çıkış olacağı garanti değildir. Betik bloklarının sırası önemliyse, bir nesnesini kullanarak StringBuilder betikleri tek bir dizede bir araya getirin ve sonra hepsini tek bir istemci betik bloğuna kaydedin.

Ayrıca bkz.

RegisterClientScriptBlock(Type, String, String, Boolean)

Şunlara uygulanır

RegisterClientScriptBlock(Type, String, String, Boolean)

betik etiketleri eklenip eklenmeyeceğini Page belirten bir tür, anahtar, betik değişmez değeri ve Boole değeri kullanarak istemci betiğini nesnesine kaydeder.

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

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

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

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

Parametreler

type: Type

Kaydedilecek istemci betiğinin türü.

key: String

Kaydedilecek istemci betiğinin anahtarı.

script: String

Kaydedilecek istemci betiği değişmez değeri.

addScriptTags: Boolean

Betik etiketleri eklenip eklenmeyeceğini gösteren Boole değeri.

Özel durumlar

ArgumentNullException

İstemci betiği blok türü şeklindedir null.

Örnekler

Aşağıdaki kod örneği, yönteminin RegisterClientScriptBlock kullanımını gösterir. addScriptTags Başlangıç ve kapanış betiği etiketlerinin parametreye dahil edilmemesi için true parametresinin script olarak ayarlandığını unutmayın.

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

IsClientScriptBlockRegistered Belirli bir anahtara ve tür çiftine sahip bir istemci betiğinin zaten kayıtlı olup olmadığını belirlemek için yöntemini çağırın. Bu, betiği gereksiz yere eklemeye çalışmaktan kaçınmanızı sağlar.

yönteminin RegisterClientScriptBlock bu aşırı yüklemesinde, parametresinde sağlanan betiğin script parametresini kullanarak <script> bir addScriptTags öğe bloğuyla sarmalanıp sarmalanmayacağını belirtebilirsiniz. ayarı addScriptTagstrue , betik etiketlerinin otomatik olarak ekleneceğini gösterir.

Ayrıca bkz.

RegisterClientScriptBlock(Type, String, String)

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?