ScriptManager.RegisterStartupScript Yöntem

Tanım

Ad Alanı:

System.Web.UI

Bütünleştirilmiş Kod:

System.Web.Extensions.dll

Bir başlangıç betik bloğunu ScriptManager denetime kaydeder ve betik bloğunu sayfaya ekler.

Aşırı Yüklemeler

RegisterStartupScript(Control, Type, String, String, Boolean)	denetimi kullanarak ScriptManager içindeki UpdatePanel bir denetim için bir başlangıç betik bloğu kaydeder ve betik bloğunu sayfaya ekler.
RegisterStartupScript(Page, Type, String, String, Boolean)	Denetimle 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 ScriptManager içindeki UpdatePanel bir denetim için bir başlangıç betik bloğu kaydeder 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 değeridir.

-veya- type, null değeridir.

ArgumentException

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

Açıklamalar

Kısmi sayfa işleme ile uyumlu ve Microsoft Ajax Kitaplığı bağımlılıkları olmayan bir sayfaya başlangıç betiği bloğu kaydetmek için yöntemini 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 bir geri gönderme gerçekleştiğinde bir 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. Nesneye başvuruyu ClientScriptManager sayfanın özelliğinden ClientScript 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ırayla çıkış garantisi sunulmaz. Başlangıç betik 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)

Denetimle 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. Betik bloğunun yalnızca denetim güncelleştirildiğinde UpdatePanel kaydedilmesi için denetimin içindeki bir UpdatePanel denetime betik bloğu 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. Nesneye başvuruyu ClientScriptManager sayfanın özelliğinden ClientScript alabilirsiniz.

Ayrıca bkz.

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