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

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

Aşırı Yüklemeler

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, 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ış betik etiketlerinin parametresine script eklendiğini unutmayın. Betik etiketlerini ek parametre ayarına göre eklemek 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 kaydetme girişimi, betiğin bir kopyasını oluşturmaz.

IsStartupScriptRegistered Belirli bir anahtar ve tür çiftine 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 kaydedildikleri sırayla çıkış olacağı garanti değildir. 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.

RegisterStartupScript(Type, String, String, Boolean)

Şunlara uygulanır

RegisterStartupScript(Type, String, String, Boolean)

Bir tür, anahtar, 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 belirten boole değeri.

Özel durumlar

ArgumentNullException

type, null değeridir.

Örnekler

Aşağıdaki kod örneği yönteminin RegisterStartupScript kullanımını gösterir. parametresinin addScriptTags olarak false ayarlandığını, dolayısıyla başlangıç ve kapanış betik etiketlerinin parametresine 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 kaydetme girişimi, betiğin bir kopyasını oluşturmaz.

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

Şunlara uygulanır

Aracılığıyla paylaş

ClientScriptManager.RegisterStartupScript Yöntem

Tanım

Aşırı Yüklemeler

RegisterStartupScript(Type, String, String)

Parametreler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

RegisterStartupScript(Type, String, String, Boolean)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Ek kaynaklar