ClientScriptManager.RegisterClientScriptBlock 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 clientscript bij het Page object.

Overloads

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

RegisterClientScriptBlock(Type, String, String)

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

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)

Parameters

type: Type

Het type clientscript dat moet worden geregistreerd.

key: String

De sleutel van het clientscript dat moet worden geregistreerd.

script: String

Het letterlijke clientscript dat moet worden geregistreerd.

Voorbeelden

In het volgende codevoorbeeld ziet u het gebruik van de RegisterClientScriptBlock 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 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>

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 IsClientScriptBlockRegistered methode aan om te bepalen of een clientscript 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 RegisterClientScriptBlock methode moet u ervoor zorgen dat het script dat is opgegeven in de script parameter is verpakt in een <script> elementblok.

Met RegisterClientScriptBlock de methode wordt een scriptblok toegevoegd aan de bovenkant van de weergegeven pagina. 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

RegisterClientScriptBlock(Type, String, String, Boolean)

Van toepassing op

RegisterClientScriptBlock(Type, String, String, Boolean)

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

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)

Parameters

type: Type

Het type clientscript dat moet worden geregistreerd.

key: String

De sleutel van het clientscript dat moet worden geregistreerd.

script: String

Het letterlijke clientscript dat moet worden geregistreerd.

addScriptTags: Boolean

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

Uitzonderingen

ArgumentNullException

Het type clientscriptblok is null.

Voorbeelden

In het volgende codevoorbeeld ziet u het gebruik van de RegisterClientScriptBlock methode. Houd er rekening mee dat de addScriptTags parameter zodanig is ingesteld true dat de scripttags voor het begin en het sluiten van scripts niet zijn 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

Roep de IsClientScriptBlockRegistered methode aan om te bepalen of een clientscript met een bepaalde sleutel en typepaar al is geregistreerd. Hiermee kunt u voorkomen dat u onnodig probeert het script toe te voegen.

In deze overbelasting van de RegisterClientScriptBlock 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

RegisterClientScriptBlock(Type, String, String)

Van toepassing op

Feedback

Is deze pagina nuttig?