Aracılığıyla paylaş

ClientScriptManager.RegisterClientScriptInclude Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI
Bütünleştirilmiş Kod:
System.Web.dll

İstemci betiğinin dahil olduğu Page nesnesini kaydeder.

Aşırı Yüklemeler

RegisterClientScriptInclude(String, String)

İstemci betiğini Page , istemciden çağrılmayı sağlayan bir anahtar ve URL kullanarak nesnesine kaydeder.
RegisterClientScriptInclude(Type, String, String)

Bir tür, anahtar ve URL kullanarak istemci betiğini nesnesiyle birlikte Page kaydeder.

RegisterClientScriptInclude(String, String)

İstemci betiğini Page , istemciden çağrılmayı sağlayan bir anahtar ve URL kullanarak nesnesine kaydeder.

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)

Parametreler

key
String

İstemci betiğinin anahtarı kaydolmayı içerir.

url
String

İstemci betiğinin URL'si kaydolmayı içerir.

Örnekler

Söz dizimi, kullanım ve bir örnek de dahil olmak üzere ilgili bilgiler için bkz RegisterClientScriptInclude. .

Açıklamalar

İstemci betiği, anahtarı ve türüyle benzersiz bir şekilde tanımlanır. Aynı anahtara ve türe sahip betikler yinelenen olarak kabul edilir. Belirli bir türe ve anahtar çifte sahip yalnızca bir betik sayfaya kaydedilebilir. Zaten kaydedilmiş bir betiği kaydetmeye çalışmak, betiğin bir kopyasını oluşturmaz.

Bir istemci betiğinin IsClientScriptIncludeRegistered belirli bir anahtarla birlikte eklenip eklenmediğini ve tür çiftinin zaten kayıtlı olup olmadığını belirlemek için yöntemini çağırın ve gereksiz yere betiği eklemeye çalışmaktan kaçının.

Not

İstemci URL'sini çözümlemek için yöntemini kullanın ResolveClientUrl . Bu yöntem, yolu çözümlemek için çağrıldığı URL bağlamını kullanır.

Yönteminin RegisterClientScriptInclude bu aşırı yüklemesi , URLve type parametresini alan keyaşırı yüklemeyi çağırır.

yöntemi, işlenen sayfanın en üstüne bir betik bloğu ekler.

Ayrıca bkz.

Şunlara uygulanır

RegisterClientScriptInclude(Type, String, String)

Bir tür, anahtar ve URL kullanarak istemci betiğini nesnesiyle birlikte Page kaydeder.

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)

Parametreler

type
Type

İstemci betiğinin türü, kaydolmayı içerir.

key
String

İstemci betiğinin anahtarı kaydolmayı içerir.

url
String

İstemci betiğinin URL'si kaydolmayı içerir.

Özel durumlar

ArgumentNullException

İstemci betiği ekleme türü: null.

ArgumentException

URL şeklindedir null.

-veya- URL boş.

Örnekler

Aşağıdaki kod örneği yönteminin RegisterClientScriptInclude kullanımını gösterir. Mevcut istemci betiğini denetleme mantığı kaldırılırsa, yöntem yinelenenleri denetlediğinden RegisterClientScriptInclude işlenen sayfada yine de yinelenen istemci betikleri olmayacağını unutmayın. Denetlemenin avantajı, gereksiz hesaplamaları azaltmaktır.

<%@ 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>

Bu örnekte aşağıdaki içeriklere sahip Script_include.js adlı bir JavaScript dosyası gerekir:

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

Açıklamalar

Yöntemin RegisterClientScriptInclude bu aşırı yüklemesi, betiği tanımlamak için anahtar ve URL parametrelerinin yanı sıra istemci betiğinin tanımlanmasını belirten bir type parametre alır. Türü kaynağa erişecek nesneye göre belirtirsiniz. Örneğin, kaynağa erişmek için bir Page örnek kullanırken türünü belirtirsiniz Page .

Not

İstemci URL'sini çözümlemek için yöntemini kullanın ResolveClientUrl . Bu yöntem, yolu çözümlemek için çağrıldığı URL bağlamını kullanır.

Bu yöntem, işlenen sayfanın en üstüne bir betik bloğu ekler.

Ayrıca bkz.

Şunlara uygulanır