Aracılığıyla paylaş

ClientScriptManager.IsClientScriptIncludeRegistered Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI
Bütünleştirilmiş Kod:
System.Web.dll

İstemci betiğinin içermesinin nesnesine Page kaydedilip kaydedilmediğini belirler.

Aşırı Yüklemeler

IsClientScriptIncludeRegistered(String)

İstemci betiğinin belirtilen anahtar kullanılarak nesneye Page kaydedilip kaydedilmediğini belirler.
IsClientScriptIncludeRegistered(Type, String)

İstemci betiğinin bir anahtar ve tür kullanarak nesneye Page kaydedilip kaydedilmediğini belirler.

IsClientScriptIncludeRegistered(String)

İstemci betiğinin belirtilen anahtar kullanılarak nesneye Page kaydedilip kaydedilmediğini belirler.

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

Parametreler

key
String

İstemci betiğinin anahtarı için arama yapılır.

Döndürülenler

Boolean

true istemci betiği dahil kayıtlıysa; aksi takdirde , false.

Açıklamalar

Yinelenen betiklerin kaydedilmesini RegisterClientScriptInclude önlemek için yöntemini çağırmadan önce bu yöntemi çağırın. Betiğin oluşturulması için çok fazla miktarda sunucu kaynağı gerekiyorsa bu özellikle önemlidir.

İstemci betiği, anahtarı ve türüyle benzersiz bir şekilde tanımlanır. Aynı anahtara ve türe sahip betikler yinelenen olarak kabul edilir.

Yönteminin IsStartupScriptRegistered bu aşırı yüklemesi, türü nesne olarak Page ayarlanmış hem hem key de parametresini type alan aşırı yüklemeyi çağırır.

Ayrıca bkz.

Şunlara uygulanır

IsClientScriptIncludeRegistered(Type, String)

İstemci betiğinin bir anahtar ve tür kullanarak nesneye Page kaydedilip kaydedilmediğini belirler.

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

Parametreler

type
Type

Aranacak istemci betiğinin türü.

key
String

İstemci betiğinin anahtarı için arama yapılır.

Döndürülenler

Boolean

true istemci betiği dahil kayıtlıysa; aksi takdirde , false.

Özel durumlar

ArgumentNullException

İstemci betiği ekleme türü: null.

Örnekler

Aşağıdaki kod örneği yönteminin IsClientScriptIncludeRegistered kullanımını gösterir. Mevcut istemci betiğini denetleme mantığı kaldırılırsa, yöntem yinelenenleri denetlediğinden işlenen sayfanın RegisterClientScriptInclude HTML kaynak kodunda iki yinelenen istemci betiği olmayacağını unutmayın. Denetlemenin avantajı, gereksiz hesaplamaları azaltmaktır.

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

Bu örnekte, aşağıdaki içeriklere sahip adlı Script_include.jsbir JavaScript dosyası gerekir:

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

Açıklamalar

Yinelenen istemci betiğinin RegisterClientScriptInclude içermesini kaydetmekten kaçınmak için yöntemini çağırmadan önce bu yöntemi çağırın. Betiğin oluşturulması için çok fazla miktarda sunucu kaynağı gerekiyorsa bu özellikle önemlidir.

İstemci betiği, anahtarı ve türüyle benzersiz bir şekilde tanımlanır. Aynı anahtara ve türe sahip betikler yinelenen olarak kabul edilir. Türü kaynağa erişecek nesneye göre belirtirsiniz. Örneğin, kaynağa erişmek için bir Sayfa örneği kullanırken türü belirtirsiniz Page .

Ayrıca bkz.

Şunlara uygulanır