Page.RegisterStartupScript(String, String) 메서드

정의

주의

The recommended alternative is ClientScript.RegisterStartupScript(Type type, string key, string script). http://go.microsoft.com/fwlink/?linkid=14202

클라이언트 쪽 스크립트 블록을 페이지 응답으로 내보냅니다.

public:
 virtual void RegisterStartupScript(System::String ^ key, System::String ^ script);
public virtual void RegisterStartupScript (string key, string script);
[System.Obsolete("The recommended alternative is ClientScript.RegisterStartupScript(Type type, string key, string script). http://go.microsoft.com/fwlink/?linkid=14202")]
public virtual void RegisterStartupScript (string key, string script);
abstract member RegisterStartupScript : string * string -> unit
override this.RegisterStartupScript : string * string -> unit
[<System.Obsolete("The recommended alternative is ClientScript.RegisterStartupScript(Type type, string key, string script). http://go.microsoft.com/fwlink/?linkid=14202")>]
abstract member RegisterStartupScript : string * string -> unit
override this.RegisterStartupScript : string * string -> unit
Public Overridable Sub RegisterStartupScript (key As String, script As String)

매개 변수

key
String

스크립트 블록을 식별하는 고유 키입니다.

script
String

클라이언트에 보낼 스크립트의 내용입니다.

특성

예제

다음 코드 예제에서는 메서드와 함께 메서드를 RegisterStartupScript 사용하는 방법을 보여 줍니다 IsStartupScriptRegistered . 메서드 RegisterStartupScript 에 의해 IsStartupScriptRegistered 결정된 대로 코드 선언 블록에 작성된 ECMAScript가 아직 등록되지 않은 경우 호출이 이루어집니다.

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

설명

메서드와 RegisterClientScriptBlock 마찬가지로 메서드는 RegisterStartupScript 개체 <form runat= server> 요소의 닫는 태그 바로 앞에 스크립트를 Page 내보낸다. 매개 변수에 지정된 스크립트 블록 문자열 주위에 여는 요소와 닫는 <script>script 요소를 포함해야 합니다.

이 메서드는 키를 사용하여 스크립트 블록을 식별하기 때문에 다른 서버 컨트롤 인스턴스에서 요청할 때마다 스크립트 블록을 출력 스트림으로 내보냅니다.

매개 변수 값이 동일한 key 모든 스크립트 블록은 중복된 것으로 간주됩니다.

참고

요청 브라우저에서 스크립트를 지원하지 않는 경우 렌더링되지 않도록 스크립트 주위에 HTML 주석 태그를 포함해야 합니다.

RegisterStartupScript 메서드는 사용되지 않습니다. 대신 RegisterStartupScript 클래스의 ClientScriptManager 메서드를 사용합니다.

적용 대상

추가 정보