ClientScriptManager.RegisterStartupScript Methode

Definitie

Naamruimte:: System.Web.UI

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Registreert het opstartscript bij het Page object.

Overloads

Name	Description
RegisterStartupScript(Type, String, String)	Registreert het opstartscript bij het Page object met behulp van een type, een sleutel en een letterlijk script.
RegisterStartupScript(Type, String, String, Boolean)	Registreert het opstartscript bij het Page object met behulp van een type, een sleutel, een letterlijk script en een Booleaanse waarde die aangeeft of er scripttags moeten worden toegevoegd.

RegisterStartupScript(Type, String, String)

Registreert het opstartscript bij het Page object met behulp van een type, een sleutel en een letterlijk script.

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)

Parameters

type: Type

Het type opstartscript dat moet worden geregistreerd.

key: String

De sleutel van het opstartscript dat moet worden geregistreerd.

script: String

Het letterlijke opstartscript dat moet worden geregistreerd.

Voorbeelden

In het volgende codevoorbeeld ziet u het gebruik van de RegisterStartupScript methode. Houd er rekening mee dat de beginnende en afsluitende scripttags zijn opgenomen in de script parameter. Als u wilt dat de scripttags worden toegevoegd op basis van een extra parameterinstelling, raadpleegt u de RegisterStartupScript methode.

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

Opmerkingen

Een clientscript wordt uniek geïdentificeerd door de sleutel en het bijbehorende type. Scripts met dezelfde sleutel en hetzelfde type worden beschouwd als duplicaten. Er kan slechts één script met een bepaald type en sleutelpaar worden geregistreerd bij de pagina. Als u een script probeert te registreren dat al is geregistreerd, wordt er geen duplicaat van het script gemaakt.

Roep de IsStartupScriptRegistered methode aan om te bepalen of een opstartscript met een bepaalde sleutel en typepaar al is geregistreerd en vermijd onnodig een poging om het script toe te voegen.

Bij deze overbelasting van de RegisterStartupScript methode moet u ervoor zorgen dat het script dat is opgegeven in de script parameter is verpakt met een <script> elementblok.

Het scriptblok dat door de RegisterStartupScript methode wordt toegevoegd, wordt uitgevoerd wanneer de pagina is geladen, maar voordat de gebeurtenis van OnLoad de pagina wordt gegenereerd. De scriptblokken worden niet gegarandeerd uitgevoerd in de volgorde waarin ze zijn geregistreerd. Als de volgorde van de scriptblokken belangrijk is, gebruikt u een StringBuilder object om de scripts samen te verzamelen in één tekenreeks en registreert u ze allemaal in één clientscriptblok.

Zie ook

RegisterStartupScript(Type, String, String, Boolean)

Van toepassing op

RegisterStartupScript(Type, String, String, Boolean)

Registreert het opstartscript bij het Page object met behulp van een type, een sleutel, een letterlijk script en een Booleaanse waarde die aangeeft of er scripttags moeten worden toegevoegd.

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)

Parameters

type: Type

Het type opstartscript dat moet worden geregistreerd.

key: String

De sleutel van het opstartscript dat moet worden geregistreerd.

script: String

Het letterlijke opstartscript dat moet worden geregistreerd.

addScriptTags: Boolean

Een Booleaanse waarde die aangeeft of er scripttags moeten worden toegevoegd.

Uitzonderingen

ArgumentNullException

type is null.

Voorbeelden

In het volgende codevoorbeeld ziet u het gebruik van de RegisterStartupScript methode. Houd er rekening mee dat de addScriptTags parameter zodanig is ingesteld false dat de scripttags voor het begin en het sluiten van scripts worden opgenomen in de script parameter.

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

Opmerkingen

Een opstartscript wordt uniek geïdentificeerd door de sleutel en het bijbehorende type. Scripts met dezelfde sleutel en hetzelfde type worden beschouwd als duplicaten. Er kan slechts één script met een bepaald type en sleutelpaar worden geregistreerd bij de pagina. Als u een script probeert te registreren dat al is geregistreerd, wordt er geen duplicaat van het script gemaakt.

Roep de IsStartupScriptRegistered methode aan om te bepalen of een opstartscript met een bepaalde sleutel en typepaar al is geregistreerd en vermijd onnodig een poging om het script toe te voegen.

In deze overbelasting van de RegisterStartupScript methode kunt u aangeven of het script dat is opgegeven in de script parameter is verpakt met een <script> elementblok met behulp van de addScriptTags parameter. Instelling addScriptTags om aan te true geven dat scripttags automatisch worden toegevoegd.

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?