ClientScriptManager.IsOnSubmitStatementRegistered メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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 -> boolPublic Function IsOnSubmitStatementRegistered (type As Type, key As String) As Booleanパラメーター
- type
- Type
検索対象の OnSubmit ステートメントの型。
- key
- String
検索対象の OnSubmit ステートメントのキー。
戻り値
OnSubmit ステートメントが登録されている場合は true。それ以外の場合は 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 -> boolPublic Function IsOnSubmitStatementRegistered (key As String) As Booleanパラメーター
- key
- String
検索対象の OnSubmit ステートメントのキー。
戻り値
OnSubmit ステートメントが登録されている場合は true。それ以外の場合は false。
注釈
重複する OnSubmit ステートメントを登録しないように、メソッドを RegisterOnSubmitStatement 呼び出す前にこのメソッドを呼び出します。 これは、ステートメントで大量のサーバー リソースを作成する必要がある場合に特に重要です。
ステートメントは、そのキーとその型によって一意に識別されます。 同じキーと型を持つステートメントは重複と見なされます。
このメソッドのオーバーロードは、 IsOnSubmitStatementRegistered 型がオブジェクトとして設定された a key とパラメーターの両方を type 受け取るオーバーロードを Page 呼び出します。