ScriptManager.RegisterStartupScript Yöntem

Tanım

Ad Alanı:

System.Web.UI

Bütünleştirilmiş Kod:

System.Web.Extensions.dll

Denetime ScriptManager bir başlangıç betiği bloğu kaydeder ve betik bloğunu sayfaya ekler.

Aşırı Yüklemeler

Name	Description
RegisterStartupScript(Control, Type, String, String, Boolean)	denetimi kullanarak içindeki bir denetim UpdatePanel için başlangıç betiği bloğu kaydeder ScriptManager ve betik bloğunu sayfaya ekler.
RegisterStartupScript(Page, Type, String, String, Boolean)	Denetime ScriptManager her zaman uyumsuz geri gönderme için bir başlangıç betiği bloğu kaydeder ve betik bloğunu sayfaya ekler.

RegisterStartupScript(Control, Type, String, String, Boolean)

denetimi kullanarak içindeki bir denetim UpdatePanel için başlangıç betiği bloğu kaydeder ScriptManager ve betik bloğunu sayfaya ekler.

public:
 static void RegisterStartupScript(System::Web::UI::Control ^ control, Type ^ type, System::String ^ key, System::String ^ script, bool addScriptTags);

public static void RegisterStartupScript(System.Web.UI.Control control, Type type, string key, string script, bool addScriptTags);

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

Public Shared Sub RegisterStartupScript (control As Control, type As Type, key As String, script As String, addScriptTags As Boolean)

Parametreler

control

Control

İstemci betik bloğunu kaydeden denetim.

type

Type

İstemci betik bloğunun 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 bloğu için benzersiz bir tanımlayıcı.

script

String

Kaydedilecek betik.

addScriptTags

Boolean

true ve etiketleriyle <script></script> betik bloğunu içine almak için; aksi takdirde , false.

Özel durumlar

ArgumentNullException

control, null'e eşittir.

-veya-

type, null'e eşittir.

ArgumentException

control sayfanın denetim ağacında değil.

Açıklamalar

Yöntemini, kısmi sayfa işleme ile uyumlu olan ve Microsoft Ajax Kitaplığı bağımlılıkları olmayan bir sayfa için başlangıç betiği bloğunu kaydetmek için kullanırsınız RegisterStartupScript . Bu yöntem kullanılarak kaydedilen başlangıç betiği blokları, yalnızca bloğu kaydeden denetim güncelleştirilmekte olan bir UpdatePanel denetimin içinde olduğunda sayfaya gönderilir. Zaman uyumsuz geri gönderme her gerçekleştiğinde başlangıç betiği bloğunu kaydetmek için bu yöntemin RegisterStartupScript(Page, Type, String, String, Boolean) aşırı yüklemesini kullanın.

Kısmi sayfa güncelleştirmeleri ile ilgili olmayan bir başlangıç betiği kaydetmek istiyorsanız ve betiği ilk sayfa işleme sırasında yalnızca bir kez kaydetmek istiyorsanız, sınıfının yöntemini ClientScriptManager kullanınRegisterStartupScript. Sayfanın özelliğinden nesneye ClientScript başvuru ClientScriptManager alabilirsiniz.

Yöntemi tarafından RegisterStartupScript işlenen betik bloğu, sayfanın yüklenmesi tamamlandığında ancak sayfanın istemci onload olayı tetiklenmeden önce yürütülür. Başlangıç betiği blokları, işlenen ASP.NET sayfasının alt kısmında etiketin </form> hemen önünde bulunur.

kullanılarak RegisterStartupScript kaydedilen başlangıç betiği bloklarının, kaydedildikleri sırada çıkışları garanti edilmez. Başlangıç betiği bloklarının sırası önemliyse, betik bloklarını tek bir dizede toplamak için bir StringBuilder nesnesi kullanın ve sonra hepsini tek bir başlangıç betiği olarak kaydedin.

Ayrıca bkz.

• RegisterStartupScript(Page, Type, String, String, Boolean)

RegisterStartupScript(Page, Type, String, String, Boolean)

Denetime ScriptManager her zaman uyumsuz geri gönderme için bir başlangıç betiği bloğu kaydeder ve betik bloğunu sayfaya ekler.

public:
 static void RegisterStartupScript(System::Web::UI::Page ^ page, Type ^ type, System::String ^ key, System::String ^ script, bool addScriptTags);

public static void RegisterStartupScript(System.Web.UI.Page page, Type type, string key, string script, bool addScriptTags);

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

Public Shared Sub RegisterStartupScript (page As Page, type As Type, key As String, script As String, addScriptTags As Boolean)

Parametreler

page

Page

İstemci betik bloğunu kaydeden sayfa nesnesi.

type

Type

İstemci betik bloğunun 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 bloğu için benzersiz bir tanımlayıcı.

script

String

Kaydedilecek betik.

addScriptTags

Boolean

true ve etiketleriyle <script></script> betik bloğunu içine almak için; aksi takdirde , false.

Açıklamalar

Zaman uyumsuz bir geri gönderme gerçekleştiğinde dahil edilen bir başlangıç betiği bloğunu kaydetmek için bu yöntemi kullanırsınız. Yalnızca denetim güncelleştirildiğinde UpdatePanel betik bloğunun kaydedilmesi için denetimin içindeki bir UpdatePanel denetim için betik bloğunu kaydetmek için bu yöntemin RegisterStartupScript(Control, Type, String, String, Boolean) aşırı yüklemesini kullanın.

Kısmi sayfa güncelleştirmeleri ile ilgili olmayan bir başlangıç betiği kaydetmek istiyorsanız ve betiği ilk sayfa işleme sırasında yalnızca bir kez kaydetmek istiyorsanız, sınıfının yöntemini ClientScriptManager kullanınRegisterStartupScript. Sayfanın özelliğinden nesneye ClientScript başvuru ClientScriptManager alabilirsiniz.

Ayrıca bkz.

• RegisterStartupScript(Control, Type, String, String, Boolean)