ClientScriptManager.IsStartupScriptRegistered Metódus

Definíció

Névtér:: System.Web.UI

Szerelvény:: System.Web.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Meghatározza, hogy az indítási szkript regisztrálva van-e az Page objektumban.

Túlterhelések

Name	Description
IsStartupScriptRegistered(Type, String)	Meghatározza, hogy az indítási szkript regisztrálva van-e az Page objektumban a megadott kulccsal és típussal.
IsStartupScriptRegistered(String)	Meghatározza, hogy az indítási szkript regisztrálva van-e az Page objektumban a megadott kulccsal.

IsStartupScriptRegistered(Type, String)

Meghatározza, hogy az indítási szkript regisztrálva van-e az Page objektumban a megadott kulccsal és típussal.

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

Paraméterek

type: Type

A keresendő indítási szkript típusa.

key: String

A keresendő indítási szkript kulcsa.

Válaszok

Boolean

trueha az indítási szkript regisztrálva van; egyéb esetben. false

Kivételek

ArgumentNullException

Az indítási szkript típusa.null

Példák

Az alábbi példakód a metódus használatát IsStartupScriptRegistered mutatja be. Vegye figyelembe, hogy ha a meglévő indítási szkriptblokk ellenőrzésére szolgáló logika el lett távolítva, a renderelt oldal HTML-forráskódjában nem lenne két ismétlődő indítási szkript, mert a RegisterStartupScript metódus duplikált elemeket keres. Az ellenőrzés előnye a szükségtelen számítások csökkentése.

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

Megjegyzések

Hívja meg ezt a metódust, mielőtt meghívja a metódust, RegisterStartupScript hogy elkerülje az ismétlődő szkriptek regisztrálását. Ez különösen akkor fontos, ha a szkript létrehozásához nagy mennyiségű kiszolgálói erőforrás szükséges.

Az ügyfélindítási szkripteket a kulcs és a típus egyedileg azonosítja. Az azonos kulccsal és típussal rendelkező szkriptek duplikáltnak minősülnek.

Lásd még

A következőre érvényes:

IsStartupScriptRegistered(String)

Meghatározza, hogy az indítási szkript regisztrálva van-e az Page objektumban a megadott kulccsal.

public:
 bool IsStartupScriptRegistered(System::String ^ key);

public bool IsStartupScriptRegistered(string key);

member this.IsStartupScriptRegistered : string -> bool

Public Function IsStartupScriptRegistered (key As String) As Boolean

Paraméterek

key: String

A keresendő indítási szkript kulcsa.

Válaszok

Boolean

trueha az indítási szkript regisztrálva van; egyéb esetben. false

Megjegyzések

Az indítási szkripteket a kulcs és a típus egyedileg azonosítja. Az azonos kulccsal és típussal rendelkező szkriptek duplikáltnak minősülnek.

A metódus túlterhelése meghívja IsStartupScriptRegistered azt a túlterhelést, amely egy sztringet key és egy type objektumként beállított típust tartalmazó paramétert Page is tartalmaz

Lásd még

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?