ClientScriptManager.RegisterClientScriptBlock Yöntem

Başvuru

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

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)	İstemci betiğini nesneye Page kaydederken betik etiketlerinin eklenip eklenmeyeceğini belirten bir tür, anahtar, betik değişmez değeri ve Boole değeri kullanılır.

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 bir şekilde 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 kaydedilmiş 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 script sağlanan betiğin bir <script> öğe bloğunda sarmalandığından emin olmanız gerekir.

yöntemi, RegisterClientScriptBlock işlenen sayfanın en üstüne bir betik bloğu ekler. Betik bloklarının kaydedildikleri sırayla çıkış olacağı garanti edilmez. Betik bloklarının sırası önemliyse, betikleri tek bir dizede bir araya getirmek için bir StringBuilder nesnesi kullanın 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)

İstemci betiğini nesneye Page kaydederken betik etiketlerinin eklenip eklenmeyeceğini belirten bir tür, anahtar, betik değişmez değeri ve Boole değeri kullanılır.

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 belirten 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. parametresinin addScriptTags olarak ayarlandığını true , dolayısıyla başlangıç ve kapanış betik etiketlerinin parametreye script dahil edilmediğini 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 anahtar 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ışmamanızı sağlar.

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

Ayrıca bkz.

RegisterClientScriptBlock(Type, String, String)

Şunlara uygulanır

Aracılığıyla paylaş

ClientScriptManager.RegisterClientScriptBlock Yöntem

Tanım

Aşırı Yüklemeler

RegisterClientScriptBlock(Type, String, String)

Parametreler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

RegisterClientScriptBlock(Type, String, String, Boolean)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Ek kaynaklar