ClientScriptManager.IsOnSubmitStatementRegistered Метод

  • Ссылка

Определение

Пространство имен:
System.Web.UI
Сборка:
System.Web.dll

Определяет, зарегистрирован ли оператор OnSubmit с объектом Page.

Перегрузки

IsOnSubmitStatementRegistered(Type, String)

Определяет, зарегистрирован ли оператор OnSubmit с объектом Page, используя указанные ключ и тип.
IsOnSubmitStatementRegistered(String)

Определяет, зарегистрирован ли оператор OnSubmit с объектом Page, используя указанный ключ.

IsOnSubmitStatementRegistered(Type, String)

Определяет, зарегистрирован ли оператор OnSubmit с объектом Page, используя указанные ключ и тип.

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

Параметры

type
Type

Тип оператора OnSubmit, используемый для поиска.

key
String

Ключ оператора OnSubmit, используемый для поиска.

Возвращаемое значение

Boolean

true, если оператор OnSubmit зарегистрирован; в противном случае — false.

Исключения

ArgumentNullException

Тип оператора OnSubmit — null.

Примеры

В следующем примере кода показано использование IsOnSubmitStatementRegistered метода . Скрипт с именем OnSubmitScript регистрируется в Page , чтобы при отправке формы страницы вызывался скрипт.

<%@ 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 script on the page.
    String csname = "OnSubmitScript";
    Type cstype = this.GetType();
        
    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;

    // Check to see if the OnSubmit statement is already registered.
    if (!cs.IsOnSubmitStatementRegistered(cstype, csname))
    {
      String cstext = "document.write('Text from OnSubmit statement');";
      cs.RegisterOnSubmitStatement(cstype, csname, cstext);
    }

  }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form    id="Form1"
            runat="server">
     <input type="submit"
            value="Submit" />
     </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 script on the page.
    Dim csname As String = "OnSubmitScript"
    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 OnSubmit statement is already registered.
    If (Not cs.IsOnSubmitStatementRegistered(cstype, csname)) Then
      
      Dim cstext As String = "document.write('Text from OnSubmit statement.');"
      cs.RegisterOnSubmitStatement(cstype, csname, cstext)
      
    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="submit"
            value="Submit" />
     </form>
  </body>
</html>

Комментарии

Вызовите этот метод перед вызовом RegisterOnSubmitStatement метода , чтобы избежать регистрации повторяющихся инструкций. Это особенно важно, если для создания инструкции требуется большое количество ресурсов сервера.

Оператор уникально идентифицируется по его ключу и типу. Операторы с одним и тем же ключом и типом считаются дубликатами. Тип указывается на основе объекта, который будет обращаться к ресурсу. Например, при использовании экземпляра Page для доступа к ресурсу Page укажите тип .

См. также раздел

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

IsOnSubmitStatementRegistered(String)

Определяет, зарегистрирован ли оператор OnSubmit с объектом Page, используя указанный ключ.

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

Параметры

key
String

Ключ оператора OnSubmit, используемый для поиска.

Возвращаемое значение

Boolean

true, если оператор OnSubmit зарегистрирован; в противном случае — false.

Комментарии

Вызовите этот метод перед вызовом RegisterOnSubmitStatement метода , чтобы избежать регистрации повторяющихся инструкций OnSubmit. Это особенно важно, если для создания инструкции требуется большое количество ресурсов сервера.

Оператор уникально идентифицируется по его ключу и типу. Операторы с одним и тем же ключом и типом считаются дубликатами.

Эта перегрузка IsOnSubmitStatementRegistered метода вызывает перегрузку, которая принимает и key параметр с типомtype, заданным в качестве объекта.Page

См. также раздел

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