다음을 통해 공유

ScriptManager.RegisterClientScriptResource 메서드

정의

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

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

오버로드

Name Description
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 메서드 모두 스크립트 파일을 브라우저에 로드합니다. 형식과 키가 같은 스크립트(스크립트 파일의 경우) 또는 동일한 형식 및 리소스 이름(포함된 리소스의 경우)이 이미 로드된 경우 스크립트가 다시 로드되지 않습니다.

추가 정보

적용 대상