ClientScriptManager Sınıf

Başvuru

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.

Web uygulamalarında istemci betiklerini yönetme yöntemlerini tanımlar.

public ref class ClientScriptManager sealed

public sealed class ClientScriptManager

type ClientScriptManager = class

Public NotInheritable Class ClientScriptManager

Devralma: Object
ClientScriptManager

Örnekler

Aşağıdaki kod örneği, sınıfının yönteminin RegisterClientScriptBlock ClientScriptManager kullanımını gösterir. Sayfada iki istemci betiği tanımlanır: PopupScriptsayfa yüklendiğinde bir uyarı iletisi görüntüleyen ve ButtonClickScripthtml düğmesinin onClick olayı için bir istemci işleyicisi tanımlayan .

<%@ 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 and type of the client scripts on the page.
    String csname1 = "PopupScript";
    String csname2 = "ButtonClickScript";
    Type cstype = this.GetType();
        
    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;

    // Check to see if the startup script is already registered.
    if (!cs.IsStartupScriptRegistered(cstype, csname1))
    {
      String cstext1 = "alert('Hello World');";
      cs.RegisterStartupScript(cstype, csname1, cstext1, true);
    }

    // Check to see if the client script is already registered.
    if (!cs.IsClientScriptBlockRegistered(cstype, csname2))
    {
      StringBuilder cstext2 = new StringBuilder();
      cstext2.Append("<script type=\"text/javascript\"> function DoClick() {");
      cstext2.Append("Form1.Message.value='Text from client script.'} </");
      cstext2.Append("script>");
      cs.RegisterClientScriptBlock(cstype, csname2, cstext2.ToString(), false);
    }
  }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form id="Form1"
         runat="server">
        <input type="text" id="Message" /> <input type="button" value="ClickMe" onclick="DoClick()" />
     </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 and type of the client scripts on the page.
    Dim csname1 As String = "PopupScript"
    Dim csname2 As String = "ButtonClickScript"
    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 startup script is already registered.
    If (Not cs.IsStartupScriptRegistered(cstype, csname1)) Then
      
      Dim cstext1 As String = "alert('Hello World');"
      cs.RegisterStartupScript(cstype, csname1, cstext1, True)
      
    End If
    
    ' Check to see if the client script is already registered.
    If (Not cs.IsClientScriptBlockRegistered(cstype, csname2)) Then
      
      Dim cstext2 As New StringBuilder()
            cstext2.Append("<script type=""text/javascript""> function DoClick() {")
      cstext2.Append("Form1.Message.value='Text from client script.'} </")
      cstext2.Append("script>")
      cs.RegisterClientScriptBlock(cstype, csname2, cstext2.ToString(), False)
      
    End If
    
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form id="Form1"
         runat="server">
        <input type="text" id="Message" /> <input type="button" value="ClickMe" onclick="DoClick()" />
     </form>
  </body>
</html>

Açıklamalar

ClientScriptManager sınıfı, istemci betiklerini yönetmek ve bunları Web uygulamalarına eklemek için kullanılır. nesnesinin ClientScriptManager özelliğinden Page sınıfına ClientScript bir başvuru alabilirsiniz.

Web sayfasına bildirimli olarak, betiği sayfanın HTML işaretlemesine ekleyerek istemci betiği ekleyebilirsiniz. Ancak, istemci betiğini dinamik olarak eklemenin gerekli olduğu durumlar vardır. Betiği dinamik olarak eklemek için, betiği RegisterClientScriptInclude ne zaman ve nasıl eklemek istediğinize bağlı olarak yöntemini, yönteminiRegisterStartupScript, yöntemini veya RegisterOnSubmitStatement yöntemini kullanınRegisterClientScriptBlock. Daha fazla bilgi için bkz . Nasıl yapılır: ASP.NET Web Sayfalarına İstemci Betiği Dinamik Olarak Ekleme.

sınıfı betikleri ClientScriptManager bir anahtar String ve ile benzersiz olarak Typetanımlar. Aynı anahtara ve türe sahip betikler yinelenen olarak kabul edilir. Betik türünü kullanmak, sayfada kullanımda olabilecek farklı kullanıcı denetimlerindeki benzer betiklerin karıştırılmasını önlemeye yardımcı olur.

sınıfı, ClientScriptManager geri gönderme gerçekleştirmeden istemciden sunucu kodu çalıştırmanın istendiğinde istemci geri çağırmalarını çağırmak için kullanılabilir. Bu, sunucuya bant dışı geri çağırma gerçekleştirme olarak adlandırılır. İstemci geri çağırmasında, istemci betik işlevi ASP.NET Web sayfasına zaman uyumsuz istek gönderir. Web sayfası, geri çağırmayı işlemek için normal yaşam döngüsünün değiştirilmiş bir sürümünü çalıştırır. GetCallbackEventReference Çağrıldığında bir sunucu olayına istemci geri çağırması başlatan bir istemci işlevine başvuru almak için yöntemini kullanın. Daha fazla bilgi için bkz. Geri Gönderme Olmadan İstemci Geri Çağırmaları Uygulama.

Not

Betik geri çağırmaları, Belge Nesne Modeli'ni (DOM) desteklemeyen eski tarayıcılarda çalışmaz ve istemcide ECMAScript'in etkinleştirilmesini gerektirir. Tarayıcının geri çağırmaları destekleyip desteklemediğini denetlemek için, ASP.NET iç nesnesinin Request özelliği aracılığıyla Browser erişilebilen özelliğini kullanınSupportsCallback.

GetPostBackEventReference İstemci geri gönderme olayını tanımlamak için yöntemini ve GetPostBackClientHyperlink yöntemini kullanın. Bu yöntemler, çağrıldığında istemci betik işlevlerinin sunucunun sayfaya geri göndermesine neden olmasını sağlar. bir istemci geri gönderme olayı, Web sayfasının istemci geri gönderme olayını işlemek için normal bir yaşam döngüsü tamamlayan istemci geri çağırmasından farklıdır.

Not

Bir Button denetim kullanıyorsanız ve UseSubmitBehavior özelliği olarak falseayarlandıysa, denetimin GetPostBackEventReference istemci geri gönderme olayını döndürmek için Button yöntemini kullanabilirsiniz.

OnClientClick Denetimin, ImageButton denetimin ve LinkButton denetimin Button özelliği istemci betiğini çalıştırmak için kullanılabilir.

Yöntemler

Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetCallbackEventReference(Control, String, String, String)	Çağrıldığında bir sunucu olayına istemci çağrısı başlatan bir istemci işlevine başvuru alır. Bu aşırı yüklenmiş yöntemin istemci işlevi belirtilen denetimi, bağımsız değişkeni, istemci betiğini ve bağlamı içerir.
GetCallbackEventReference(Control, String, String, String, Boolean)	Çağrıldığında sunucu olaylarına yönelik bir istemci çağrısı başlatan bir istemci işlevine başvuru alır. Bu aşırı yüklenmiş yöntemin istemci işlevi, belirtilen bir denetim, bağımsız değişken, istemci betiği, bağlam ve Boole değeri içerir.
GetCallbackEventReference(Control, String, String, String, String, Boolean)	Çağrıldığında sunucu olaylarına yönelik bir istemci çağrısı başlatan bir istemci işlevine başvuru alır. Bu aşırı yüklenmiş yöntemin istemci işlevi belirtilen denetimi, bağımsız değişkeni, istemci betiğini, bağlamı, hata işleyicisini ve Boole değerini içerir.
GetCallbackEventReference(String, String, String, String, String, Boolean)	Çağrıldığında sunucu olaylarına yönelik bir istemci çağrısı başlatan bir istemci işlevine başvuru alır. Bu aşırı yüklenmiş yöntemin istemci işlevi belirtilen bir hedef, bağımsız değişken, istemci betiği, bağlam, hata işleyicisi ve Boole değeri içerir.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetPostBackClientHyperlink(Control, String)	Belirtilen denetim için ve belirtilen olay bağımsız değişkenleriyle `javascript:` sunucuya geri göndermek üzere bir istemci olayında kullanılabilecek, başına eklenmiş bir başvuru alır.
GetPostBackClientHyperlink(Control, String, Boolean)	Belirtilen olay bağımsız değişkenleriyle `javascript:` belirtilen denetim için sunucuya geri göndermek üzere bir istemci olayında kullanılabilen ve olay doğrulaması için gönderinin geri kaydedilip kaydedilmeyeceğini belirten bir başvuru alır.
GetPostBackEventReference(Control, String)	Bir istemci olayında sunucuya geri göndermeye neden olmak için kullanılabilecek bir dize döndürür. Başvuru dizesi, geri göndermeyi işleyen belirtilen denetim ve ek olay bilgilerinin dize bağımsız değişkeni tarafından tanımlanır.
GetPostBackEventReference(Control, String, Boolean)	Sunucuya geri göndermeye neden olmak için istemci olayında kullanılacak bir dize döndürür. Başvuru dizesi, geri göndermeyi işleyen belirtilen denetim ve ek olay bilgilerinin dize bağımsız değişkeni tarafından tanımlanır. İsteğe bağlı olarak, doğrulama için olay başvuruyu kaydeder.
GetPostBackEventReference(PostBackOptions)	Bir istemci olayında sunucuya geri göndermeye neden olmak için kullanılabilecek bir dize döndürür. Başvuru dizesi belirtilen PostBackOptions örnek tarafından tanımlanır.
GetPostBackEventReference(PostBackOptions, Boolean)	Bir istemci olayında sunucuya geri göndermeye neden olmak için kullanılabilecek bir dize döndürür. Başvuru dizesi belirtilen PostBackOptions nesne tarafından tanımlanır. İsteğe bağlı olarak, doğrulama için olay başvuruyu kaydeder.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
GetWebResourceUrl(Type, String)	Derlemedeki bir kaynağa URL başvurusu alır.
IsClientScriptBlockRegistered(String)	İstemci betik bloğunun belirtilen anahtarı kullanarak nesneye Page kaydedilip kaydedilmediğini belirler.
IsClientScriptBlockRegistered(Type, String)	İstemci betik bloğunun bir anahtar ve tür kullanarak nesneye Page kaydedilip kaydedilmediğini belirler.
IsClientScriptIncludeRegistered(String)	İstemci betiğinin belirtilen anahtar kullanılarak nesneye Page kaydedilip kaydedilmediğini belirler.
IsClientScriptIncludeRegistered(Type, String)	İstemci betiğinin bir anahtar ve tür kullanarak nesneye Page kaydedilip kaydedilmediğini belirler.
IsOnSubmitStatementRegistered(String)	OnSubmit deyiminin belirtilen anahtar kullanılarak nesneye Page kaydedilip kaydedilmediğini belirler.
IsOnSubmitStatementRegistered(Type, String)	OnSubmit deyiminin belirtilen anahtar ve tür kullanılarak nesneye Page kaydedilip kaydedilmediğini belirler.
IsStartupScriptRegistered(String)	Başlangıç betiğinin belirtilen anahtar kullanılarak nesneye Page kaydedilip kaydedilmediğini belirler.
IsStartupScriptRegistered(Type, String)	Başlangıç betiğinin belirtilen anahtar ve tür kullanılarak nesneye Page kaydedilip kaydedilmediğini belirler.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
RegisterArrayDeclaration(String, String)	Bir dizi adı ve dizi değeri kullanarak nesnesiyle Page bir JavaScript dizi bildirimi kaydeder.
RegisterClientScriptBlock(Type, String, String)	Bir tür, anahtar ve betik değişmez değeri kullanarak istemci betiğini nesnesine Page kaydeder.
RegisterClientScriptBlock(Type, String, String, Boolean)	İstemci betiğini nesneye Page kaydederken betik etiketlerinin eklenip eklenmeyeceğini belirten bir tür, anahtar, betik değişmez değeri ve Boole değeri kullanılır.
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.
RegisterClientScriptResource(Type, String)	Bir tür ve kaynak adı kullanarak istemci betik kaynağını nesnesine Page kaydeder.
RegisterExpandoAttribute(String, String, String)	Bir ad/değer çiftini, denetim kimliği, öznitelik adı ve öznitelik değeri verilen belirtilen denetimin özel (expando) özniteliği olarak kaydeder.
RegisterExpandoAttribute(String, String, String, Boolean)	Bir ad/değer çiftini denetim kimliği, öznitelik adı, öznitelik değeri ve öznitelik değerinin kodlanıp kodlanmayacağını belirten boole değeri verilen belirtilen denetimin özel (expando) özniteliği olarak kaydeder.
RegisterForEventValidation(PostBackOptions)	ile PostBackOptionsdoğrulama için bir olay başvurusu kaydeder.
RegisterForEventValidation(String)	Doğrulama için olayı oluşturan istemci denetimini temsil eden benzersiz bir denetim kimliğiyle bir olay başvurusu kaydeder.
RegisterForEventValidation(String, String)	Benzersiz bir denetim kimliği ve olayı oluşturan istemci denetimini temsil eden olay bağımsız değişkenleriyle doğrulama için bir olay başvurusu kaydeder.
RegisterHiddenField(String, String)	Nesneye Page gizli bir değer kaydeder.
RegisterOnSubmitStatement(Type, String, String)	Tür, anahtar ve betik değişmez değeri kullanarak bir OnSubmit deyimini nesnesine Page kaydeder. deyimi gönderildiğinde HtmlForm yürütülür.
RegisterStartupScript(Type, String, String)	Bir tür, anahtar ve bir betik değişmez değeri kullanarak başlangıç betiğini nesnesine Page kaydeder.
RegisterStartupScript(Type, String, String, Boolean)	Bir tür, anahtar, betik değişmez değeri ve betik etiketleri eklenip eklenmeyeceğini Page belirten bir Boole değeri kullanarak başlangıç betiğini nesnesine kaydeder.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
ValidateEvent(String)	yöntemini kullanarak RegisterForEventValidation(String) olay doğrulaması için kaydedilmiş bir istemci olayını doğrular.
ValidateEvent(String, String)	yöntemini kullanarak RegisterForEventValidation(String, String) olay doğrulaması için kaydedilmiş bir istemci olayını doğrular.

Şunlara uygulanır