다음을 통해 공유

ScriptManager.RegisterClientScriptResource 메서드

  • 참조

정의

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

부분 페이지 렌더링에 참여하는 컨트롤과 함께 사용할 ScriptManager 컨트롤을 사용하여 어셈블리에 포함된 클라이언트 스크립트를 등록합니다.

오버로드

RegisterClientScriptResource(Page, Type, String)

포스트백이 발생할 때마다 ScriptManager 컨트롤을 사용하여 어셈블리에 포함된 클라이언트 스크립트 파일을 등록합니다.
RegisterClientScriptResource(Control, Type, String)

부분 페이지 렌더링에 참여하는 컨트롤과 함께 사용할 ScriptManager 컨트롤을 사용하여 어셈블리에 포함된 클라이언트 스크립트를 등록합니다.

RegisterClientScriptResource(Page, Type, String)

포스트백이 발생할 때마다 ScriptManager 컨트롤을 사용하여 어셈블리에 포함된 클라이언트 스크립트 파일을 등록합니다.

public:
 static void RegisterClientScriptResource(System::Web::UI::Page ^ page, Type ^ type, System::String ^ resourceName);
public static void RegisterClientScriptResource (System.Web.UI.Page page, Type type, string resourceName);
static member RegisterClientScriptResource : System.Web.UI.Page * Type * string -> unit
Public Shared Sub RegisterClientScriptResource (page As Page, type As Type, resourceName As String)

매개 변수

page
Page

스크립트를 등록하는 페이지 개체입니다.

type
Type

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

resourceName
String

리소스의 식별자입니다.

예외

ArgumentNullException

클라이언트 리소스 type이 null인 경우

또는 스크립트를 등록하는 페이지가 null인 경우

설명

이 메서드에 스크립트 파일을 등록하면 비동기 포스트백이 발생할 때마다 스크립트가 렌더링됩니다. 컨트롤이 업데이트될 때만 스크립트가 등록되도록 컨트롤 내에 UpdatePanel 있는 컨트롤에 대한 스크립트를 UpdatePanel 등록하려면 이 메서드의 오버로드를 RegisterClientScriptResource(Control, Type, String) 사용합니다.

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

추가 정보

적용 대상

RegisterClientScriptResource(Control, Type, String)

부분 페이지 렌더링에 참여하는 컨트롤과 함께 사용할 ScriptManager 컨트롤을 사용하여 어셈블리에 포함된 클라이언트 스크립트를 등록합니다.

public:
 static void RegisterClientScriptResource(System::Web::UI::Control ^ control, Type ^ type, System::String ^ resourceName);
public static void RegisterClientScriptResource (System.Web.UI.Control control, Type type, string resourceName);
static member RegisterClientScriptResource : System.Web.UI.Control * Type * string -> unit
Public Shared Sub RegisterClientScriptResource (control As Control, type As Type, resourceName As String)

매개 변수

control
Control

스크립트를 등록하는 컨트롤입니다.

type
Type

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

resourceName
String

리소스의 식별자입니다.

예외

ArgumentNullException

클라이언트 리소스 type이 null인 경우

또는 스크립트를 등록하는 컨트롤이 null인 경우

ArgumentException

스크립트를 등록하는 컨트롤이 페이지의 컨트롤 트리에 있지 않은 경우

설명

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

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

이 RegisterClientScriptResource 메서드는 HTTP 처리기를 통해 어셈블리의 리소스에 액세스할 때 사용됩니다. 이 메서드에는 요소의 리소스 URL 내용이 script 포함됩니다.

RegisterClientScriptInclude 두 RegisterClientScriptResource 메서드 모두 스크립트 파일을 브라우저에 로드합니다. 동일한 형식과 키를 가진 스크립트(스크립트 파일의 경우) 또는 동일한 형식 및 리소스 이름(포함된 리소스의 경우)이 이미 로드된 경우 스크립트가 다시 로드되지 않습니다.

추가 정보

적용 대상