ScriptManager.RegisterClientScriptInclude Yöntem

Başvuru

Tanım

Ad Alanı:: System.Web.UI

Bütünleştirilmiş Kod:: System.Web.Extensions.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.

Bir denetimin ScriptManager içindeki bir denetimle kullanmak üzere denetimine bir UpdatePanel istemci betik dosyası kaydeder ve ardından sayfaya bir betik dosyası başvurusu ekler.

Aşırı Yüklemeler

RegisterClientScriptInclude(Control, Type, String, String)	Bir denetimin ScriptManager içindeki bir denetimle kullanmak üzere denetimine bir UpdatePanel istemci betik dosyası kaydeder ve ardından sayfaya bir betik dosyası başvurusu ekler.
RegisterClientScriptInclude(Page, Type, String, String)	Zaman uyumsuz bir geri gönderme gerçekleştiğinde istemci betiğini denetime ScriptManager kaydeder ve ardından sayfaya bir betik dosyası başvurusu ekler.

RegisterClientScriptInclude(Control, Type, String, String)

Bir denetimin ScriptManager içindeki bir denetimle kullanmak üzere denetimine bir UpdatePanel istemci betik dosyası kaydeder ve ardından sayfaya bir betik dosyası başvurusu ekler.

public:
 static void RegisterClientScriptInclude(System::Web::UI::Control ^ control, Type ^ type, System::String ^ key, System::String ^ url);

public static void RegisterClientScriptInclude (System.Web.UI.Control control, Type type, string key, string url);

static member RegisterClientScriptInclude : System.Web.UI.Control * Type * string * string -> unit

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

Parametreler

control: Control

İstemci betik dosyasını kaydeden denetim.

type: Type

İstemci betik dosyasının türü. Bu parametre genellikle betiği kaydeden denetimin türünü almak için typeof işleci (C#) veya GetType işleci (Visual Basic) kullanılarak belirtilir.

key: String

Betik dosyasının benzersiz tanımlayıcısı.

url: String

Betik dosyasının URL'si.

Özel durumlar

ArgumentNullException

İstemci betik dosyası type şeklindedir null.

-veya- Betik dosyasını kaydeden denetim şeklindedir null.

ArgumentException

Betik dosyasını kaydeden denetim, sayfanın denetim ağacında değil.

-veya- url, null değeridir.

-veya- url boş.

Örnekler

<%@ 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)
    {
        if (!IsPostBack)
            Calendar1.SelectedDate = DateTime.Today;
        
    }
    protected void Page_PreRender(object sender, EventArgs e)
    {
        ScriptManager.RegisterClientScriptInclude(
            this,
            typeof(Page),
            "AlertScript",
            ResolveClientUrl("~/scripts/script_alertdiv.js"));
    }
    protected void IncrementButton_Click(object sender, EventArgs e)
    {
        Calendar1.SelectedDate = Calendar1.SelectedDate.AddDays(1.0);
    }
    protected void DecrementButton_Click(object sender, EventArgs e)
    {
        Calendar1.SelectedDate = Calendar1.SelectedDate.AddDays(-1.0);
    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>ScriptManager RegisterClientScriptInclude</title>
    <style type="text/css">
    div.MessageStyle
    {
      background-color: Green;
      top: 95%;
      left: 1%;
      position: absolute;
      visibility: hidden;
    }
    </style>
</head>
<body>
    <form id="Form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1"
                               runat="server"/>

            <script type="text/javascript">
            Sys.WebForms.PageRequestManager.instance.add_endRequest(Notify);
            </script>

            <asp:UpdatePanel ID="UpdatePanel1" UpdateMode="Conditional"
                runat="server">
                <ContentTemplate>
                    <asp:Calendar ID="Calendar1" runat="server"/>
                    <br />
                    Change the selected date: 
                    <asp:Button runat="server" ID="DecrementButton" Text="-" OnClick="DecrementButton_Click" />
                    <asp:Button runat="server" ID="IncrementButton" Text="+" OnClick="IncrementButton_Click" />
                </ContentTemplate>
            </asp:UpdatePanel>

            <div id="NotifyDiv" class="MessageStyle">
                Updates are complete.
            </div>
        </div>
    </form>
</body>
</html>

function Notify(sender, arg)
{
    ActivateAlertDiv('visible', 'NotifyDiv');
    setTimeout("ActivateAlertDiv('hidden', 'NotifyDiv')", 1000);
}
function ActivateAlertDiv(visstring, elem)
{
    var adiv = document.getElementById(elem);
    adiv.style.visibility = visstring;
}

Açıklamalar

Kısmi sayfa güncelleştirmelerine katılan bir sayfaya veya sayfanın bir bölümüne istemci betik dosyası kaydetmek için yöntemini kullanırsınız RegisterClientScriptInclude . Bu yöntem kullanılarak kaydedilen istemci betik dosyaları, yalnızca güncelleştirilmekte olan bir denetimin içindeki bir UpdatePanel denetimi temsil ettiğinde control sayfaya gönderilir. Zaman uyumsuz bir geri gönderme gerçekleştiğinde bir betik dosyasını kaydetmek için bu yöntemin RegisterClientScriptInclude(Page, Type, String, String) aşırı yüklemesini kullanın.

Kısmi sayfa güncelleştirmeleri ile ilgili olmayan bir betik bloğunu kaydetmek istiyorsanız ve betik bloğunu ilk sayfa işleme sırasında yalnızca bir kez kaydetmek istiyorsanız sınıfının yöntemini ClientScriptManager kullanınRegisterClientScriptBlock. Nesneye başvuruyu ClientScriptManager sayfanın özelliğinden ClientScript alabilirsiniz.

yöntemi, RegisterClientScriptInclude açılış etiketi bir öznitelik içeren bir script öğeyi işleyerek sayfaya bir src istemci betik dosyası kaydeder. url parametresi özniteliğini src ayarlamak için kullanılır. URL'leri çözmek için yöntemini kullanın ResolveClientUrl . Bu yöntem, yolu çözümlemek için çağrıldığı URL'nin bağlamını kullanır.

RegisterClientScriptInclude Hem ve RegisterClientScriptResource yöntemleri betik dosyalarını tarayıcıya işler. Aynı tür ve anahtara (betik dosyası için) veya aynı türe ve kaynak adına (eklenmiş bir kaynak için) sahip bir betik zaten işleniyorsa, betik yeniden işlenmez.

Ayrıca bkz.

RegisterClientScriptInclude(Page, Type, String, String)

Şunlara uygulanır

RegisterClientScriptInclude(Page, Type, String, String)

Zaman uyumsuz bir geri gönderme gerçekleştiğinde istemci betiğini denetime ScriptManager kaydeder ve ardından sayfaya bir betik dosyası başvurusu ekler.

public:
 static void RegisterClientScriptInclude(System::Web::UI::Page ^ page, Type ^ type, System::String ^ key, System::String ^ url);

public static void RegisterClientScriptInclude (System.Web.UI.Page page, Type type, string key, string url);

static member RegisterClientScriptInclude : System.Web.UI.Page * Type * string * string -> unit

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

Parametreler

page: Page

İstemci betik dosyasını kaydeden sayfa nesnesi.

type: Type

İstemci betik dosyasının türü. Bu parametre genellikle betiği kaydeden denetimin türünü almak için typeof işleci (C#) veya GetType işleci (Visual Basic) kullanılarak belirtilir.

key: String

Betik dosyasının benzersiz tanımlayıcısı.

url: String

Betik dosyasının URL'si.

Özel durumlar

ArgumentNullException

İstemci betik dosyası type şeklindedir null.

-veya- Betik dosyasını kaydeden sayfa şeklindedir null.

ArgumentException

url, null değeridir.

-veya- url boş.

Açıklamalar

Bu yöntemle bir betik dosyası kaydettiğinizde, zaman uyumsuz bir geri gönderme gerçekleştiğinde betik işlenir. Denetimin içindeki UpdatePanel bir denetimin betik dosyasını kaydederek betiğin yalnızca denetim güncelleştirildiğinde UpdatePanel kaydedilmesini sağlamak için bu yöntemin RegisterClientScriptInclude(Control, Type, String, String) aşırı yüklemesini kullanın.

Ayrıca bkz.

RegisterClientScriptBlock(Control, Type, String, String, Boolean)

Şunlara uygulanır

Aracılığıyla paylaş

ScriptManager.RegisterClientScriptInclude Yöntem

Tanım

Aşırı Yüklemeler

RegisterClientScriptInclude(Control, Type, String, String)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

RegisterClientScriptInclude(Page, Type, String, String)

Parametreler

Özel durumlar

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Ek kaynaklar