ClientScriptManager.IsClientScriptIncludeRegistered Метод

Определение

Определяет, зарегистрировано ли включение клиентского скрипта с объектом Page.Determines whether the client script include is registered with the Page object.

Перегрузки

IsClientScriptIncludeRegistered(String)

Определяет, зарегистрировано ли включение клиентского скрипта с объектом Page, используя указанный ключ.Determines whether the client script include is registered with the Page object using the specified key.

IsClientScriptIncludeRegistered(Type, String)

Определяет, зарегистрировано ли включение клиентского скрипта с объектом Page, используя ключ и тип.Determines whether the client script include is registered with the Page object using a key and type.

IsClientScriptIncludeRegistered(String)

Определяет, зарегистрировано ли включение клиентского скрипта с объектом Page, используя указанный ключ.Determines whether the client script include is registered with the Page object using the specified key.

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

Параметры

key
String

Ключ включения клиентского скрипта, используемый для поиска.The key of the client script include to search for.

Возвраты

true, если включение клиентского скрипта зарегистрировано; в противном случае — false.true if the client script include is registered; otherwise, false.

Комментарии

Вызовите этот метод перед вызовом RegisterClientScriptInclude метода, чтобы избежать регистрации повторяющихся скриптов.Call this method before calling the RegisterClientScriptInclude method to avoid registering duplicate scripts. Это особенно важно, если для создания скрипта требуется большой объем серверных ресурсов.This is particularly important if the script requires a large amount of server resources to create.

Включение клиентского скрипта однозначно идентифицируется по ключу и типу.A client script include is uniquely identified by its key and its type. Скрипты с одинаковыми ключом и типом считаются дубликатами.Scripts with the same key and type are considered duplicates.

Эта перегрузка IsStartupScriptRegistered метода вызывает перегрузку, которая принимает key и, и type параметр с типом, заданным как Page объект.This overload of the IsStartupScriptRegistered method calls the overload that takes both a key and a type parameter with the type set as a Page object.

Дополнительно

IsClientScriptIncludeRegistered(Type, String)

Определяет, зарегистрировано ли включение клиентского скрипта с объектом Page, используя ключ и тип.Determines whether the client script include is registered with the Page object using a key and type.

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

Параметры

type
Type

Тип включения клиентского скрипта, используемый для поиска.The type of the client script include to search for.

key
String

Ключ включения клиентского скрипта, используемый для поиска.The key of the client script include to search for.

Возвраты

true, если включение клиентского скрипта зарегистрировано; в противном случае — false.true if the client script include is registered; otherwise, false.

Исключения

Тип включения клиентского скрипта — null.The client script include type is null.

Примеры

В следующем примере кода показано использование IsClientScriptIncludeRegistered метода.The following code example demonstrates the use of the IsClientScriptIncludeRegistered method. Обратите внимание, что если была удалена логика проверки существующих клиентских скриптов, в исходном коде HTML отображаемой страницы не было бы двух повторяющихся клиентских скриптов, так как RegisterClientScriptInclude метод проверяет наличие дубликатов.Note that, if the logic to check for the existing client script include were removed, there would not be two duplicate client scripts in the HTML source code of the rendered page because the RegisterClientScriptInclude method checks for duplicates. Преимущество проверки заключается в сокращении числа ненужных вычислений.The benefit of checking is to reduce unnecessary computation.

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

Для этого примера требуется файл JavaScript с Script_include.jsименем и следующим содержимым:This example requires a JavaScript file named Script_include.js, with the following contents:

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

Комментарии

Вызовите этот метод перед вызовом RegisterClientScriptInclude метода, чтобы избежать регистрации повторяющихся включений клиентского скрипта.Call this method before calling the RegisterClientScriptInclude method to avoid registering duplicate client script includes. Это особенно важно, если для создания скрипта требуется большой объем серверных ресурсов.This is particularly important if the script requires a large amount of server resources to create.

Включение клиентского скрипта однозначно идентифицируется по ключу и типу.A client script include is uniquely identified by its key and its type. Скрипты с одинаковыми ключом и типом считаются дубликатами.Scripts with the same key and type are considered duplicates. Тип указывается на основе объекта, который будет обращаться к ресурсу.You specify the type based on the object that will be accessing the resource. Например, при использовании экземпляра страницы для доступа к ресурсу необходимо указать Page тип.For instance, when using a Page instance to access the resource, you specify the Page type.

Дополнительно

Применяется к