ClientScriptManager.RegisterClientScriptInclude Yöntem

Tanım

Ad Alanı:: System.Web.UI

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

İstemci betiğinin dahil olduğu öğesini nesnesine Page kaydeder.

Aşırı Yüklemeler

Name	Description
RegisterClientScriptInclude(String, String)	İstemci betiğini Page , istemciden çağrılmaya olanak tanıyan bir anahtar ve URL kullanarak nesnesine kaydeder.
RegisterClientScriptInclude(Type, String, String)	bir tür, anahtar ve URL kullanarak nesneye dahil Page istemci betiğini kaydeder.

RegisterClientScriptInclude(String, String)

İstemci betiğini Page , istemciden çağrılmaya olanak tanıyan 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 örnek gibi ilgili bilgiler için bkz RegisterClientScriptInclude. .

Açıklamalar

İstemci betiği, anahtarı ve türüne göre benzersiz olarak 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 kayıtlı olan bir betiği kaydetmeye çalışmak, betiğin bir kopyasını oluşturmaz.

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

Note

İstemci URL'sini çözmek 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, bir key, URLve type parametresini alan aşı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 nesneye dahil Page istemci betiğini 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'si şeklindedir null.

-veya-

URL boş.

Örnekler

Aşağıdaki kod örneği, yönteminin RegisterClientScriptInclude kullanımını gösterir. Mevcut istemci betiğinin dahil edilmesine yönelik mantık kaldırılırsa, yöntem yinelenenleri denetlediğinden RegisterClientScriptInclude işlenen sayfada yine de yinelenen istemci betikleri bulunmayacağını unutmayın. Denetimin 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önteminin 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ı belirtmek için 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 .

Note

İstemci URL'sini çözmek 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

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?