Udostępnij za pośrednictwem

ClientScriptManager.IsClientScriptIncludeRegistered Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI
Zestaw:
System.Web.dll

Określa, czy uwzględniony skrypt klienta jest zarejestrowany w Page obiekcie .

Przeciążenia

IsClientScriptIncludeRegistered(String)

Określa, czy skrypt klienta dołączany jest zarejestrowany w Page obiekcie przy użyciu określonego klucza.
IsClientScriptIncludeRegistered(Type, String)

Określa, czy skrypt klienta dołączany jest zarejestrowany w Page obiekcie przy użyciu klucza i typu.

IsClientScriptIncludeRegistered(String)

Określa, czy skrypt klienta dołączany jest zarejestrowany w Page obiekcie przy użyciu określonego klucza.

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

Parametry

key
String

Klucz skryptu klienta obejmuje wyszukiwanie.

Zwraca

Boolean

true jeśli skrypt klienta jest zarejestrowany; w przeciwnym razie , false.

Uwagi

Wywołaj tę metodę przed wywołaniem metody , RegisterClientScriptInclude aby uniknąć rejestrowania zduplikowanych skryptów. Jest to szczególnie ważne, jeśli skrypt wymaga dużej ilości zasobów serwera do utworzenia.

Dołączany skrypt klienta jest jednoznacznie identyfikowany przez jego klucz i jego typ. Skrypty z tym samym kluczem i typem są traktowane jako duplikaty.

To przeciążenie metody wywołuje przeciążenie IsStartupScriptRegistered , które przyjmuje zarówno parametr , key jak i type z typem ustawionym Page jako obiekt.

Zobacz też

Dotyczy

IsClientScriptIncludeRegistered(Type, String)

Określa, czy skrypt klienta dołączany jest zarejestrowany w Page obiekcie przy użyciu klucza i typu.

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

Parametry

type
Type

Typ skryptu klienta należy uwzględnić do wyszukania.

key
String

Klucz skryptu klienta obejmuje wyszukiwanie.

Zwraca

Boolean

true jeśli skrypt klienta jest zarejestrowany; w przeciwnym razie , false.

Wyjątki

ArgumentNullException

Typ dołączania skryptu klienta to null.

Przykłady

W poniższym przykładzie kodu pokazano użycie IsClientScriptIncludeRegistered metody . Należy pamiętać, że jeśli logika sprawdzania istniejącego skryptu klienta została usunięta, nie będzie dwóch zduplikowanych skryptów klienta w kodzie źródłowym HTML renderowanej strony, ponieważ RegisterClientScriptInclude metoda sprawdza duplikaty. Zaletą sprawdzania jest zmniejszenie niepotrzebnych obliczeń.

<%@ 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, type and url of the client script on the page.
        String csname = "ButtonClickScript";
        String csurl = "~/script_include.js";
        Type cstype = this.GetType();

        // Get a ClientScriptManager reference from the Page class.
        ClientScriptManager cs = Page.ClientScript;

        // Check to see if the include script exists already.
        if (!cs.IsClientScriptIncludeRegistered(cstype, csname))
        {
            cs.RegisterClientScriptInclude(cstype, csname, ResolveClientUrl(csurl));
        }

    }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form id="Form1" runat="server">
     <div>
        <input type="text"
               id="Message"/> 
        <input type="button" 
               value="ClickMe"
               onclick="DoClick()"/>
     </div>
     </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, type and url of the client script on the page.
        Dim csname As String = "ButtonClickScript"
        Dim csurl As String = "~/script_include.js"
        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 include script is already registered.
        If (Not cs.IsClientScriptIncludeRegistered(cstype, csname)) Then
      
            cs.RegisterClientScriptInclude(cstype, csname, ResolveClientUrl(csurl))
      
        End If
    
    End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ClientScriptManager Example</title>
</head>
<body>
     <form id="Form1" runat="server">
     <div>
        <input type="text"
               id="Message"/> 
        <input type="button" 
               value="ClickMe"
               onclick="DoClick()"/>
     </div>
     </form>
</body>
</html>

W tym przykładzie wymagany jest plik JavaScript o nazwie Script_include.js, z następującą zawartością:

function DoClick() {Form1.Message.value='Text from include script.'}

Uwagi

Wywołaj tę metodę przed wywołaniem metody , RegisterClientScriptInclude aby uniknąć rejestrowania zduplikowanego skryptu klienta. Jest to szczególnie ważne, jeśli skrypt wymaga dużej ilości zasobów serwera do utworzenia.

Dołączany skrypt klienta jest jednoznacznie identyfikowany przez jego klucz i jego typ. Skrypty z tym samym kluczem i typem są traktowane jako duplikaty. Typ określa się na podstawie obiektu, który będzie uzyskiwać dostęp do zasobu. Na przykład w przypadku używania wystąpienia strony do uzyskiwania dostępu do zasobu należy określić Page typ.

Zobacz też

Dotyczy