ClientScriptManager.RegisterStartupScript Metod

Definition

Namnområde:: System.Web.UI

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Registrerar startskriptet med Page objektet.

Överlagringar

Name	Description
RegisterStartupScript(Type, String, String)	Registrerar startskriptet Page med objektet med hjälp av en typ, en nyckel och en skriptliteral.
RegisterStartupScript(Type, String, String, Boolean)	Registrerar startskriptet Page med objektet med hjälp av en typ, en nyckel, en skriptliteral och ett booleskt värde som anger om skripttaggar ska läggas till.

RegisterStartupScript(Type, String, String)

Registrerar startskriptet Page med objektet med hjälp av en typ, en nyckel och en skriptliteral.

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)

Parametrar

type: Type

Typ av startskript som ska registreras.

key: String

Nyckeln för startskriptet som ska registreras.

script: String

Den startskriptliteral som ska registreras.

Exempel

I följande kodexempel visas hur metoden används RegisterStartupScript . Observera att taggarna för inledande och avslutande skript ingår i parametern script . Information om hur du lägger till skripttaggar baserat på ytterligare en parameterinställning finns i RegisterStartupScript metoden.

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

Kommentarer

Ett klientskript identifieras unikt av dess nyckel och dess typ. Skript med samma nyckel och typ betraktas som dubbletter. Endast ett skript med en viss typ och ett nyckelpar kan registreras på sidan. Försök att registrera ett skript som redan är registrerat skapar inte en dubblett av skriptet.

IsStartupScriptRegistered Anropa metoden för att avgöra om ett startskript med en viss nyckel och typpar redan är registrerat och undvik att försöka lägga till skriptet i onödan.

I den här överlagringen RegisterStartupScript av metoden måste du se till att skriptet som anges i parametern är omslutet script med ett <script> elementblock.

Skriptblocket som läggs till av RegisterStartupScript metoden körs när sidan har lästs in men innan sidans händelse aktiveras OnLoad . Skriptblocken garanteras inte vara utdata i den ordning de registreras. Om ordningen på skriptblocken är viktig använder du ett StringBuilder -objekt för att samla ihop skripten i en enda sträng och registrerar dem sedan i ett enda klientskriptblock.

Se även

RegisterStartupScript(Type, String, String, Boolean)

Gäller för

RegisterStartupScript(Type, String, String, Boolean)

Registrerar startskriptet Page med objektet med hjälp av en typ, en nyckel, en skriptliteral och ett booleskt värde som anger om skripttaggar ska läggas till.

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)

Parametrar

type: Type

Typ av startskript som ska registreras.

key: String

Nyckeln för startskriptet som ska registreras.

script: String

Den startskriptliteral som ska registreras.

addScriptTags: Boolean

Ett booleskt värde som anger om skripttaggar ska läggas till.

Undantag

ArgumentNullException

type är null.

Exempel

I följande kodexempel visas hur metoden används RegisterStartupScript . Observera att parametern addScriptTags är inställd på så att false taggarna för inledande och avslutande skript ingår i parametern script .

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

Kommentarer

Ett startskript identifieras unikt av dess nyckel och dess typ. Skript med samma nyckel och typ betraktas som dubbletter. Endast ett skript med en viss typ och ett nyckelpar kan registreras på sidan. Försök att registrera ett skript som redan är registrerat skapar inte en dubblett av skriptet.

IsStartupScriptRegistered Anropa metoden för att avgöra om ett startskript med en viss nyckel och typpar redan är registrerat och undvik att försöka lägga till skriptet i onödan.

I den här överlagringen RegisterStartupScript av metoden kan du ange om skriptet som anges i parametern script omsluts med ett <script> elementblock med hjälp av parametern addScriptTags . Inställningen addScriptTags anger true att skripttaggar läggs till automatiskt.

Se även

Gäller för

Feedback

Var den här sidan till hjälp?