Sdílet prostřednictvím

ClientScriptManager.IsStartupScriptRegistered Metoda

  • Reference

Definice

Obor názvů:
System.Web.UI
Sestavení:
System.Web.dll

Určuje, zda je spouštěcí skript registrován u objektu Page .

Přetížení

IsStartupScriptRegistered(Type, String)

Určuje, zda je spouštěcí skript zaregistrovaný u objektu Page pomocí zadaného klíče a typu.
IsStartupScriptRegistered(String)

Určuje, zda je spouštěcí skript registrován u objektu Page pomocí zadaného klíče.

IsStartupScriptRegistered(Type, String)

Určuje, zda je spouštěcí skript zaregistrovaný u objektu Page pomocí zadaného klíče a typu.

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

Parametry

type
Type

Typ spouštěcího skriptu, který chcete vyhledat.

key
String

Klíč spouštěcího skriptu, který chcete vyhledat.

Návraty

Boolean

truepokud je spouštěcí skript zaregistrovaný; v opačném případě . false

Výjimky

ArgumentNullException

Typ spouštěcího skriptu je null.

Příklady

Následující příklad kódu ukazuje použití IsStartupScriptRegistered metody. Mějte na paměti, že pokud byla logika pro kontrolu existujícího bloku spouštěcího skriptu odebrána, nebudou ve zdrojovém kódu HTML vykreslené stránky dva duplicitní spouštěcí skripty, protože RegisterStartupScript metoda kontroluje duplicity. Výhodou kontroly je snížení nepotřebných výpočtů.

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

Poznámky

Tuto metodu zavolejte před voláním RegisterStartupScript metody, aby se zabránilo registraci duplicitních skriptů. To je obzvláště důležité, pokud skript k vytvoření vyžaduje velké množství prostředků serveru.

Spouštěcí skript klienta je jednoznačně identifikován jeho klíčem a jeho typem. Skripty se stejným klíčem a typem se považují za duplicitní.

Viz také

Platí pro

IsStartupScriptRegistered(String)

Určuje, zda je spouštěcí skript registrován u objektu Page pomocí zadaného klíče.

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

Parametry

key
String

Klíč spouštěcího skriptu, který se má vyhledat.

Návraty

Boolean

true je-li spouštěcí skript registrován; falsev opačném případě .

Poznámky

Tuto metodu zavolejte před voláním RegisterStartupScript metody, aby se zabránilo registraci duplicitních skriptů. To je obzvláště důležité, pokud skript k vytvoření vyžaduje velké množství prostředků serveru.

Spouštěcí skript je jednoznačně identifikován jeho klíčem a jeho typem. Skripty se stejným klíčem a typem se považují za duplicitní.

Toto přetížení IsStartupScriptRegistered metody volá přetížení, které přebírá řetězec key i type parametr se sadou typů jako objekt.Page

Viz také

Platí pro