ClientScriptManager.IsStartupScriptRegistered Methode

Definitie

Naamruimte:
System.Web.UI
Assembly:
System.Web.dll

Bepaalt of het opstartscript is geregistreerd bij het Page object.

Overloads

Name Description
IsStartupScriptRegistered(Type, String)

Bepaalt of het opstartscript is geregistreerd bij het Page object met behulp van de opgegeven sleutel en het opgegeven type.
IsStartupScriptRegistered(String)

Bepaalt of het opstartscript is geregistreerd bij het Page object met behulp van de opgegeven sleutel.

IsStartupScriptRegistered(Type, String)

Bepaalt of het opstartscript is geregistreerd bij het Page object met behulp van de opgegeven sleutel en het opgegeven type.

public:
 bool IsStartupScriptRegistered(Type ^ type, System::String ^ key);
public bool IsStartupScriptRegistered(Type type, string key);
member this.IsStartupScriptRegistered : Type * string -> bool
Public Function IsStartupScriptRegistered (type As Type, key As String) As Boolean

Parameters

type
Type

Het type opstartscript dat moet worden gezocht.

key
String

De sleutel van het opstartscript om naar te zoeken.

Retouren

Boolean

true als het opstartscript is geregistreerd; anders, false.

Uitzonderingen

ArgumentNullException

Het opstartscripttype is null.

Voorbeelden

In het volgende codevoorbeeld ziet u het gebruik van de IsStartupScriptRegistered methode. Als de logica om te controleren op het bestaande opstartscriptblok is verwijderd, zijn er geen twee dubbele opstartscripts in de HTML-broncode van de weergegeven pagina omdat de RegisterStartupScript methode controleert op duplicaten. Het voordeel van het controleren is om onnodige berekeningen te verminderen.

<%@ 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 deze methode aan voordat u de RegisterStartupScript methode aanroept om te voorkomen dat dubbele scripts worden geregistreerd. Dit is met name belangrijk als voor het script een grote hoeveelheid serverbronnen nodig is om te maken.

Een opstartscript voor de client wordt uniek geïdentificeerd door de sleutel en het bijbehorende type. Scripts met dezelfde sleutel en hetzelfde type worden beschouwd als duplicaten.

Zie ook

Van toepassing op

IsStartupScriptRegistered(String)

Bepaalt of het opstartscript is geregistreerd bij het Page object met behulp van de opgegeven sleutel.

public:
 bool IsStartupScriptRegistered(System::String ^ key);
public bool IsStartupScriptRegistered(string key);
member this.IsStartupScriptRegistered : string -> bool
Public Function IsStartupScriptRegistered (key As String) As Boolean

Parameters

key
String

De sleutel van het opstartscript om naar te zoeken.

Retouren

Boolean

true als het opstartscript is geregistreerd; anders, false.

Opmerkingen

Roep deze methode aan voordat u de RegisterStartupScript methode aanroept om te voorkomen dat dubbele scripts worden geregistreerd. Dit is met name belangrijk als voor het script een grote hoeveelheid serverbronnen nodig is om te maken.

Een opstartscript wordt uniek geïdentificeerd door de sleutel en het bijbehorende type. Scripts met dezelfde sleutel en hetzelfde type worden beschouwd als duplicaten.

Deze overbelasting van de IsStartupScriptRegistered methode roept de overbelasting aan die zowel een tekenreeks key als een type parameter gebruikt met het type dat is ingesteld als een Page object

Zie ook

Van toepassing op