ClientScriptManager.IsOnSubmitStatementRegistered Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет, зарегистрирована ли инструкция 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 для поиска.
Возвращаемое значение
true Значение , если инструкция OnSubmit зарегистрирована; falseв противном случае .
Исключения
Тип оператора 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 для поиска.
Возвращаемое значение
true Значение , если инструкция OnSubmit зарегистрирована; falseв противном случае .
Комментарии
Вызовите этот метод перед вызовом RegisterOnSubmitStatement метода, чтобы избежать регистрации повторяющихся инструкций OnSubmit. Это особенно важно, если для создания инструкции требуется большое количество ресурсов сервера.
Оператор уникально идентифицируется по ключу и его типу. Операторы с тем же ключом и типом считаются повторяющимися.
Эта перегрузка IsOnSubmitStatementRegistered метода вызывает перегрузку, которая принимает как параметр key , так и type параметр с типом, заданным Page в качестве объекта.