ScriptManager.RegisterStartupScript 메서드

  • 참조

정의

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

ScriptManager 컨트롤을 사용하여 시작 스크립트 블록을 등록하고 해당 스크립트 블록을 페이지에 추가합니다.

오버로드

RegisterStartupScript(Control, Type, String, String, Boolean)

UpdatePanel 컨트롤을 사용하여 ScriptManager 내에 있는 컨트롤에 대해 시작 스크립트 블록을 등록한 후 해당 스크립트 블록을 페이지에 추가합니다.
RegisterStartupScript(Page, Type, String, String, Boolean)

ScriptManager 컨트롤을 사용하여 비동기 포스트백이 발생할 때마다 시작 스크립트 블록을 등록하고 페이지에 스크립트 블록을 추가합니다.

RegisterStartupScript(Control, Type, String, String, Boolean)

UpdatePanel 컨트롤을 사용하여 ScriptManager 내에 있는 컨트롤에 대해 시작 스크립트 블록을 등록한 후 해당 스크립트 블록을 페이지에 추가합니다.

public:
 static void RegisterStartupScript(System::Web::UI::Control ^ control, Type ^ type, System::String ^ key, System::String ^ script, bool addScriptTags);
public static void RegisterStartupScript (System.Web.UI.Control control, Type type, string key, string script, bool addScriptTags);
static member RegisterStartupScript : System.Web.UI.Control * Type * string * string * bool -> unit
Public Shared Sub RegisterStartupScript (control As Control, type As Type, key As String, script As String, addScriptTags As Boolean)

매개 변수

control
Control

클라이언트 스크립트 블록을 등록하는 컨트롤입니다.

type
Type

클라이언트 스크립트 블록의 형식입니다. 이 매개 변수는 일반적으로 typeof 연산자(C#) 또는 GetType 연산자(Visual Basic)로 스크립트를 등록하는 컨트롤의 형식을 검색하여 지정됩니다.

key
String

스크립트 블록의 고유한 식별자입니다.

script
String

등록할 스크립트입니다.

addScriptTags
Boolean

스크립트 블록을 true 및 <script> 태그로 묶으면 </script>이고, 그렇지 않으면 false입니다.

예외

ArgumentNullException

control이(가) null인 경우

또는 type이(가) null인 경우

ArgumentException

control이 페이지의 컨트롤 트리에 있지 않은 경우

설명

이 메서드를 RegisterStartupScript 사용하여 부분 페이지 렌더링과 호환되고 Microsoft Ajax 라이브러리 종속성이 없는 페이지에 대한 시작 스크립트 블록을 등록합니다. 이 메서드를 사용하여 등록된 시작 스크립트 블록은 블록을 등록하는 컨트롤이 업데이트되는 컨트롤 내에 있는 경우에만 페이지로 UpdatePanel 전송됩니다. 비동기 포스트백이 발생할 때마다 시작 스크립트 블록을 등록하려면 이 메서드의 오버로드를 RegisterStartupScript(Page, Type, String, String, Boolean) 사용합니다.

부분 페이지 업데이트와 관련이 없는 시작 스크립트를 등록하고 초기 페이지 렌더링 중에 스크립트를 한 번만 등록하려면 클래스의 ClientScriptManager 메서드를 사용합니다RegisterStartupScript. 페이지의 속성에서 개체에 대한 참조 ClientScriptManager 를 ClientScript 가져올 수 있습니다.

메서드에 의해 RegisterStartupScript 렌더링되는 스크립트 블록은 페이지 로드가 완료되면 페이지의 클라이언트 onload 이벤트가 발생하기 전에 실행됩니다. 시작 스크립트 블록은 태그 바로 앞에 </form> 렌더링된 ASP.NET 페이지의 맨 아래에 있습니다.

사용하여 RegisterStartupScript 등록된 시작 스크립트 블록은 등록된 순서와 동일한 순서로 출력되도록 보장되지 않습니다. 시작 스크립트 블록의 순서가 중요한 경우 개체를 StringBuilder 사용하여 단일 문자열로 스크립트 블록을 수집한 다음 모두 단일 시작 스크립트로 등록합니다.

추가 정보

적용 대상

RegisterStartupScript(Page, Type, String, String, Boolean)

ScriptManager 컨트롤을 사용하여 비동기 포스트백이 발생할 때마다 시작 스크립트 블록을 등록하고 페이지에 스크립트 블록을 추가합니다.

public:
 static void RegisterStartupScript(System::Web::UI::Page ^ page, Type ^ type, System::String ^ key, System::String ^ script, bool addScriptTags);
public static void RegisterStartupScript (System.Web.UI.Page page, Type type, string key, string script, bool addScriptTags);
static member RegisterStartupScript : System.Web.UI.Page * Type * string * string * bool -> unit
Public Shared Sub RegisterStartupScript (page As Page, type As Type, key As String, script As String, addScriptTags As Boolean)

매개 변수

page
Page

클라이언트 스크립트 블록을 등록하는 페이지 개체입니다.

type
Type

클라이언트 스크립트 블록의 형식입니다. 이 매개 변수는 일반적으로 typeof 연산자(C#) 또는 GetType 연산자(Visual Basic)로 스크립트를 등록하는 컨트롤의 형식을 검색하여 지정됩니다.

key
String

스크립트 블록의 고유한 식별자입니다.

script
String

등록할 스크립트입니다.

addScriptTags
Boolean

스크립트 블록을 true 및 <script> 태그로 묶으면 </script>이고, 그렇지 않으면 false입니다.

설명

이 메서드를 사용하여 비동기 포스트백이 발생할 때마다 포함된 시작 스크립트 블록을 등록합니다. 컨트롤이 업데이트될 때만 UpdatePanel 스크립트 블록이 등록되도록 컨트롤 내부에 UpdatePanel 있는 컨트롤에 대한 스크립트 블록을 등록하려면 이 메서드의 오버로드를 RegisterStartupScript(Control, Type, String, String, Boolean) 사용합니다.

부분 페이지 업데이트와 관련이 없는 시작 스크립트를 등록하고 초기 페이지 렌더링 중에 스크립트를 한 번만 등록하려면 클래스의 ClientScriptManager 메서드를 사용합니다RegisterStartupScript. 페이지의 속성에서 개체에 대한 참조 ClientScriptManager 를 ClientScript 가져올 수 있습니다.

추가 정보

적용 대상