ClientScriptManager.IsStartupScriptRegistered Metod

Definition

Namnområde:
System.Web.UI
Sammansättning:
System.Web.dll

Avgör om startskriptet är registrerat med Page objektet.

Överlagringar

Name Description
IsStartupScriptRegistered(Type, String)

Avgör om startskriptet är registrerat med objektet med Page den angivna nyckeln och typen.
IsStartupScriptRegistered(String)

Avgör om startskriptet är registrerat med objektet med Page den angivna nyckeln.

IsStartupScriptRegistered(Type, String)

Avgör om startskriptet är registrerat med objektet med Page den angivna nyckeln och typen.

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

Parametrar

type
Type

Typ av startskript att söka efter.

key
String

Nyckeln för startskriptet att söka efter.

Returer

Boolean

trueom startskriptet är registrerat; annars . false

Undantag

ArgumentNullException

Startskripttypen är null.

Exempel

I följande kodexempel visas hur metoden används IsStartupScriptRegistered . Observera att om logiken för att söka efter det befintliga startskriptblocket har tagits bort skulle det inte finnas två duplicerade startskript i HTML-källkoden för den renderade sidan eftersom RegisterStartupScript metoden söker efter dubbletter. Fördelen med att kontrollera är att minska onödig beräkning.

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

Anropa den här metoden innan du RegisterStartupScript anropar metoden för att undvika att registrera duplicerade skript. Detta är särskilt viktigt om skriptet kräver en stor mängd serverresurser för att skapa.

Ett klientstartskript identifieras unikt av dess nyckel och dess typ. Skript med samma nyckel och typ betraktas som dubbletter.

Se även

Gäller för

IsStartupScriptRegistered(String)

Avgör om startskriptet är registrerat med objektet med Page den angivna nyckeln.

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

Parametrar

key
String

Nyckeln för startskriptet att söka efter.

Returer

Boolean

trueom startskriptet är registrerat; annars . false

Kommentarer

Anropa den här metoden innan du RegisterStartupScript anropar metoden för att undvika att registrera duplicerade skript. Detta är särskilt viktigt om skriptet kräver en stor mängd serverresurser för att skapa.

Ett startskript identifieras unikt av dess nyckel och dess typ. Skript med samma nyckel och typ betraktas som dubbletter.

Den här överlagringen IsStartupScriptRegistered av metoden anropar överbelastningen som tar både en sträng key och en type parameter med typuppsättningen som ett Page objekt

Se även

Gäller för