ClientScriptManager.RegisterClientScriptInclude 메서드

참조

정의

네임스페이스:: System.Web.UI

어셈블리:: System.Web.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

클라이언트 스크립트 포함을 Page 개체에 등록합니다.

오버로드

RegisterClientScriptInclude(String, String)	키와 URL을 사용하여 Page 개체와 함께 클라이언트 스크립트를 등록하여 클라이언트에서 스크립트를 호출할 수 있습니다.
RegisterClientScriptInclude(Type, String, String)	형식, 키 및 URL을 사용하여 클라이언트 스크립트 포함을 Page 개체에 등록합니다.

RegisterClientScriptInclude(String, String)

키와 URL을 사용하여 Page 개체와 함께 클라이언트 스크립트를 등록하여 클라이언트에서 스크립트를 호출할 수 있습니다.

public:
 void RegisterClientScriptInclude(System::String ^ key, System::String ^ url);

public void RegisterClientScriptInclude (string key, string url);

member this.RegisterClientScriptInclude : string * string -> unit

Public Sub RegisterClientScriptInclude (key As String, url As String)

매개 변수

key: String

등록할 클라이언트 스크립트 포함의 키입니다.

url: String

등록할 클라이언트 스크립트 포함의 URL입니다.

예제

구문, 사용법 및 예를 들어, 등의 관련된 정보를 참조 하세요. RegisterClientScriptInclude합니다.

설명

클라이언트 스크립트 포함의 키 및 해당 형식에 따라 고유 하 게 식별 됩니다. 동일한 키와 형식을 사용 하 여 스크립트에는 중복으로 간주 됩니다. 지정 된 형식 및 키 쌍을 사용 하 여 하나의 스크립트 페이지를 사용 하 여 등록할 수 있습니다. 이미 등록 되어 있는 스크립트를 등록 하는 동안 스크립트의 중복을 만들지 않습니다.

호출 된 IsClientScriptIncludeRegistered 확인 여부 지정된 된 키를 사용 하 여 클라이언트 스크립트 포함 및 형식 쌍 이미 등록 되어 불필요 하 게 스크립트를 추가 하려는 시도 방지 하는 방법입니다.

참고

클라이언트 URL를 해결 하려면 사용 된 ResolveClientUrl 메서드. 이 메서드는 경로를 확인 호출 하는 URL의 컨텍스트를 사용 합니다.

이 오버 로드는 RegisterClientScriptInclude 메서드는 오버 로드를 호출 하는 key, URL, 및 type 매개 변수.

메서드는 렌더링된 된 페이지의 맨 위에 있는 스크립트 블록을 추가합니다.

추가 정보

적용 대상

RegisterClientScriptInclude(Type, String, String)

형식, 키 및 URL을 사용하여 클라이언트 스크립트 포함을 Page 개체에 등록합니다.

public:
 void RegisterClientScriptInclude(Type ^ type, System::String ^ key, System::String ^ url);

public void RegisterClientScriptInclude (Type type, string key, string url);

member this.RegisterClientScriptInclude : Type * string * string -> unit

Public Sub RegisterClientScriptInclude (type As Type, key As String, url As String)

매개 변수

type: Type

등록할 클라이언트 스크립트 포함의 형식입니다.

key: String

등록할 클라이언트 스크립트 포함의 키입니다.

url: String

등록할 클라이언트 스크립트 포함의 URL입니다.

예외

ArgumentNullException

클라이언트 스크립트 포함 형식이 null인 경우

ArgumentException

URL은 null입니다.

또는 URL이 비어 있는 경우

예제

다음 코드 예제에서는 RegisterClientScriptInclude 메서드. 기존 클라이언트 스크립트 포함을 확인 하는 논리 제거 된 경우는 여전히 없습니다 있을 중복 된 클라이언트 스크립트 렌더링된 된 페이지에 있으므로 RegisterClientScriptInclude 중복에 대 한 메서드를 확인 합니다. 불필요 한 계산을 위해 검사의 장점은입니다.

<%@ 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)
    {
        // Define the name, type and url of the client script on the page.
        String csname = "ButtonClickScript";
        String csurl = "~/script_include.js";
        Type cstype = this.GetType();

        // Get a ClientScriptManager reference from the Page class.
        ClientScriptManager cs = Page.ClientScript;

        // Check to see if the include script exists already.
        if (!cs.IsClientScriptIncludeRegistered(cstype, csname))
        {
            cs.RegisterClientScriptInclude(cstype, csname, ResolveClientUrl(csurl));
        }

    }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form id="Form1" runat="server">
     <div>
        <input type="text"
               id="Message"/> 
        <input type="button" 
               value="ClickMe"
               onclick="DoClick()"/>
     </div>
     </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 System.EventArgs)

        ' Define the name, type and url of the client script on the page.
        Dim csname As String = "ButtonClickScript"
        Dim csurl As String = "~/script_include.js"
        Dim cstype As Type = Me.GetType()
    
        ' Get a ClientScriptManager reference from the Page class.
        Dim cs As ClientScriptManager = Page.ClientScript
    
        ' Check to see if the include script is already registered.
        If (Not cs.IsClientScriptIncludeRegistered(cstype, csname)) Then
      
            cs.RegisterClientScriptInclude(cstype, csname, ResolveClientUrl(csurl))
      
        End If
    
    End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ClientScriptManager Example</title>
</head>
<body>
     <form id="Form1" runat="server">
     <div>
        <input type="text"
               id="Message"/> 
        <input type="button" 
               value="ClickMe"
               onclick="DoClick()"/>
     </div>
     </form>
</body>
</html>

이 예제에는 같은 내용이 다음 콘텐츠로 라는 JavaScript 파일이 필요 합니다.

function DoClick() {Form1.Message.value='Text from include script.'}

설명

이 오버 로드는 RegisterClientScriptInclude 메서드 키 하 고 url 는 스크립트를 식별 하는 매개 변수 뿐만 type 클라이언트 스크립트의 id를 지정 하려면 매개 변수를 포함 합니다. 리소스에 액세스 하는 개체를 기반으로 형식을 지정할 수 있습니다. 예를 들어 사용 하는 경우는 Page 지정할 리소스에 액세스 하는 인스턴스는 Page 형식입니다.

참고

클라이언트 URL를 해결 하려면 사용 된 ResolveClientUrl 메서드. 이 메서드는 경로를 확인 호출 하는 URL의 컨텍스트를 사용 합니다.

이 메서드는 렌더링된 된 페이지의 맨 위에 있는 스크립트 블록을 추가합니다.

추가 정보

적용 대상

다음을 통해 공유

ClientScriptManager.RegisterClientScriptInclude 메서드

정의

오버로드

RegisterClientScriptInclude(String, String)

매개 변수

예제

설명

추가 정보

적용 대상

RegisterClientScriptInclude(Type, String, String)

매개 변수

예외

예제

설명

추가 정보

적용 대상

추가 리소스