Page.IsStartupScriptRegistered(String) Page.IsStartupScriptRegistered(String) Page.IsStartupScriptRegistered(String) Page.IsStartupScriptRegistered(String) Method

定義

警告

この API は現在使われていません。

クライアント起動スクリプトが Page オブジェクトに登録されているかどうかを判断します。Determines whether the client startup script is registered with the Page object.

public:
 bool IsStartupScriptRegistered(System::String ^ key);
[System.Obsolete("The recommended alternative is ClientScript.IsStartupScriptRegistered(string key). http://go.microsoft.com/fwlink/?linkid=14202")]
public bool IsStartupScriptRegistered (string key);
member this.IsStartupScriptRegistered : string -> bool
Public Function IsStartupScriptRegistered (key As String) As Boolean

パラメーター

key
String String String String

検索対象の起動スクリプトの文字列キー。The string key of the startup script to search for.

戻り値

スタートアップ スクリプトが登録されている場合は true。それ以外の場合は falsetrue if the startup script is registered; otherwise, false.

メソッドをRegisterStartupScript IsStartupScriptRegisteredメソッドと組み合わせて使用する方法を次のコード例に示します。The following code example demonstrates the use of the RegisterStartupScript method in conjunction with the IsStartupScriptRegistered method. コード宣言ブロックで記述された ECMAScript が、によっIsStartupScriptRegistered RegisterStartupScriptて決定されたとおりに登録されていない場合は、呼び出しが行われます。If the ECMAScript written in the code declaration block has not already been registered, as determined by IsStartupScriptRegistered, then a RegisterStartupScript call is made.

<%@ 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)
  {
    String csname1 = "PopupScript";
    String csname2 = "ButtonClickScript";

    if (!IsClientScriptBlockRegistered(csname1))
    {
        String cstext1 = "<script type=\"text/javascript\">" +
            "alert('Hello World');</" + "script>";
        RegisterStartupScript(csname1, cstext1);
    }

    if (!IsClientScriptBlockRegistered(csname2))
    {
      StringBuilder cstext2 = new StringBuilder();
      cstext2.Append("<script type=\"text/javascript\"> function DoClick() {");
      cstext2.Append("Form1.Message.value='Text from client script.'} </");
      cstext2.Append("script>");
      RegisterClientScriptBlock(csname2, cstext2.ToString());
    }
  }
</script>
<html  >
  <head>
    <title>RegisterClientScriptBlock Example</title>
  </head>
  <body>
     <form id="Form1"
         runat="server">
        <input type="text" id="Message" /> <input type="button" value="ClickMe" onclick="DoClick()" />
     </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 EventArgs)
        Dim csname1 As String = "PopupScript"

        Dim csname2 As String = "ButtonClickScript"
    
        If Not IsClientScriptBlockRegistered(csname1) Then
            Dim cstext1 As String = "<script type=""text/javascript"">" & _
                "alert('Hello World');</" & "script>"
            RegisterStartupScript(csname1, cstext1)
        End If
    
        If Not IsClientScriptBlockRegistered(csname2) Then
            Dim cstext2 As New StringBuilder()
            cstext2.Append("<script type=""text/javascript""> function DoClick() {")
            cstext2.Append("Form1.Message.value='Text from client script.'} </")
            cstext2.Append("script>")
            RegisterClientScriptBlock(csname2, cstext2.ToString())
        End If
    End Sub
</script>
<html  >
  <head>
    <title>RegisterClientScriptBlock Example</title>
  </head>
  <body>
     <form id="Form1"
         runat="server">
        <input type="text" id="Message" /> <input type="button" value="ClickMe" onclick="DoClick()" />
     </form>
  </body>
</html>

注釈

を呼び出すPage.RegisterStartupScript前にこのメソッドを呼び出して、クライアント側のスクリプトを不必要にアセンブルしないようにします。Call this method before calling Page.RegisterStartupScript to avoid unnecessarily assembling the client-side script. これは、スクリプトで大量のサーバーリソースを作成する必要がある場合に特に重要です。This is particularly important if the script requires a large amount of server resources to create.

IsStartupScriptRegistered メソッドの使用は非推奨とされました。The IsStartupScriptRegistered method has been deprecated. ClientScriptManagerクラスのIsStartupScriptRegisteredメソッドを使用します。Use the IsStartupScriptRegistered method in the ClientScriptManager class.

適用対象

こちらもご覧ください