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

Başlangıç betiğini nesnesine Page kaydeder.

Aşırı Yüklemeler

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

RegisterStartupScript(Type, String, String)

Bir tür, anahtar ve bir betik değişmez değeri kullanarak başlangıç betiğini nesnesine Page kaydeder.

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

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

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

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

Parametreler

type: Type

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

key: String

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

script: String

Kaydedilecek başlangıç betiği değişmez değeri.

Örnekler

Aşağıdaki kod örneği, yönteminin RegisterStartupScript kullanımını gösterir. Başlangıç ve kapanış betiği etiketlerinin parametresine script eklendiğini unutmayın. Betik etiketlerinin ek parametre ayarına göre eklenmesini sağlamak için yöntemine RegisterStartupScript bakı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";
    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))
    {
        StringBuilder cstext1 = new StringBuilder();
        cstext1.Append("<script type=text/javascript> alert('Hello World!') </");
        cstext1.Append("script>");

        cs.RegisterStartupScript(cstype, csname1, cstext1.ToString());
    }
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>RegisterStartupScript</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    
    </div>
    </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 scripts on the page. 
        Dim csname1 As [String] = "PopupScript"
        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 New StringBuilder()
            cstext1.Append("<script type=text/javascript> alert('Hello World!') </")
            cstext1.Append("script>")
        
            cs.RegisterStartupScript(cstype, csname1, cstext1.ToString())
        End If
    End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>RegisterStartupScript</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    
    </div>
    </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.

Belirli bir anahtar ve tür çiftine IsStartupScriptRegistered sahip bir başlangıç 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 RegisterStartupScript bu aşırı yüklemesinde, parametresinde sağlanan betiğin bir script öğe bloğuyla sarmalandığından <script> emin olmanız gerekir.

Yöntemi tarafından RegisterStartupScript eklenen betik bloğu, sayfanın yüklenmesi tamamlandığında ancak sayfanın OnLoad olayı tetiklenmeden önce yürütülür. 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.

RegisterStartupScript(Type, String, String, Boolean)

Şunlara uygulanır

RegisterStartupScript(Type, String, String, Boolean)

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

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

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

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

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

Parametreler

type: Type

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

key: String

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

script: String

Kaydedilecek başlangıç betiği değişmez değeri.

addScriptTags: Boolean

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

Özel durumlar

ArgumentNullException

type, null'e eşittir.

Örnekler

Aşağıdaki kod örneği, yönteminin RegisterStartupScript kullanımını gösterir. parametresinin addScriptTags olarak ayarlandığını false , dolayısıyla başlangıç ve kapanış betiği etiketlerinin parametreye script dahil olduğunu 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

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

yönteminin RegisterStartupScript 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.

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?