Page.RegisterStartupScript(String, String) 메서드

정의

네임스페이스:
System.Web.UI
어셈블리:
System.Web.dll

주의

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

클라이언트로 전송될 스크립트의 콘텐츠입니다.

특성
ObsoleteAttribute

예제

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

<%@ 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 개체 Page 요소의 닫는 태그 바로 앞에 스크립트를 <form runat= server> 내보낸다. 매개 변수에 지정된 <script> 스크립트 블록 문자열 주위에 여는 요소와 닫는 script 요소를 포함해야 합니다.

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

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

메모

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

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

적용 대상

추가 정보