ClientScriptManager Sınıf

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 sınıfına ClientScript Page başvuru alabilirsiniz.

Betiği sayfanın HTML işaretlemesine ekleyerek web sayfasına bildirimli olarak bir 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 ne zaman ve nasıl eklemek istediğinize bağlı olarak yöntemini, yöntemini, yöntemini veya RegisterOnSubmitStatement yöntemini kullanın RegisterClientScriptBlock RegisterClientScriptInclude.RegisterStartupScript Daha fazla bilgi için bkz . Nasıl yapılır: ASP.NET Web Sayfalarına İstemci Betiği Dinamik Olarak Ekleme.

ClientScriptManager sınıfı, betikleri 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 kafa karıştırıcı olması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ştirmek olarak adlandırılır. İstemci geri çağırmasında, istemci betik işlevi bir 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.

Uyarı

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 bir istemci geri gönderme olayı 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. İstemci 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ünü tamamlayan istemci geri çağırmasından farklıdır.

Uyarı

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 Button ve LinkButton denetimin özelliği istemci betiğini çalıştırmak için kullanılabilir.

Yöntemler

Name	Description
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
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 bir denetim, bağımsız değişken, istemci betiği, bağlam, hata işleyicisi ve Boole değeri içerir.
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 bir denetim, bağımsız değişken, istemci betiği ve bağlam 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, Boolean)	Bir istemci olayında, belirtilen olay bağımsız değişkenleri ve Boole `javascript:` gösterimi ile belirtilen denetim için sunucuya geri göndermek için kullanılabilecek, başına eklenmiş bir başvuru alır ve olay doğrulaması için gönderinin geri kaydedilip kaydedilmeyeceğini gösteren Boole göstergesi.
GetPostBackClientHyperlink(Control, String)	Bir istemci olayında belirtilen denetim için ve belirtilen olay bağımsız değişkenleriyle sunucuya geri göndermek için kullanılabilecek, başına eklenmiş bir başvuru `javascript:` alı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şkeniyle tanımlanır. İsteğe bağlı olarak, doğrulama için olay başvuruyu kaydeder.
GetPostBackEventReference(Control, String)	Sunucuya geri göndermeye neden olmak için istemci olayında 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şkeniyle tanımlanır.
GetPostBackEventReference(PostBackOptions, Boolean)	Sunucuya geri göndermeye neden olmak için istemci olayında 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.
GetPostBackEventReference(PostBackOptions)	Sunucuya geri göndermeye neden olmak için istemci olayında kullanılabilecek bir dize döndürür. Başvuru dizesi belirtilen PostBackOptions örnek tarafından tanımlanır.
GetType()	Geçerli örneğin Type 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ı kullanarak 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 Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
RegisterArrayDeclaration(String, String)	Bir dizi adı ve dizi değeri kullanarak nesneye Page bir JavaScript dizi bildirimi kaydeder.
RegisterClientScriptBlock(Type, String, String, Boolean)	betik etiketleri eklenip eklenmeyeceğini Page belirten bir tür, anahtar, betik değişmez değeri ve Boole değeri kullanarak istemci betiğini nesnesine kaydeder.
RegisterClientScriptBlock(Type, String, String)	Bir tür, anahtar ve betik değişmez değeri kullanarak istemci betiğini nesnesine Page kaydeder.
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.
RegisterClientScriptResource(Type, String)	Bir tür ve kaynak adı kullanarak istemci betik kaynağını nesnesine Page kaydeder.
RegisterExpandoAttribute(String, String, String, Boolean)	Bir ad/değer çiftini, belirtilen denetimin bir denetim kimliği, öznitelik adı, öznitelik değeri ve öznitelik değerinin kodlanıp kodlanmayacağını belirten boole değeri verilen özel (expando) özniteliği olarak 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.
RegisterForEventValidation(PostBackOptions)	ile PostBackOptionsdoğrulama için bir olay başvurusu kaydeder.
RegisterForEventValidation(String, String)	Doğrulama için benzersiz bir denetim kimliği ve olayı oluşturan istemci denetimini temsil eden olay bağımsız değişkenleriyle bir olay başvurusu kaydeder.
RegisterForEventValidation(String)	Doğrulama için olay başvurularını, olayı oluşturan istemci denetimini temsil eden benzersiz bir denetim kimliğiyle kaydeder.
RegisterHiddenField(String, String)	Gizli bir değeri nesnesine Page kaydeder.
RegisterOnSubmitStatement(Type, String, String)	Bir tür, anahtar ve bir betik değişmez değeri kullanarak bir OnSubmit deyimini nesnesine Page kaydeder. gönderildiğinde HtmlForm deyimi yürütülür.
RegisterStartupScript(Type, String, String, Boolean)	Bir tür, anahtar, bir 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.
RegisterStartupScript(Type, String, String)	Bir tür, anahtar ve bir betik değişmez değeri kullanarak başlangıç betiğini nesnesine Page kaydeder.
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)
ValidateEvent(String, String)	yöntemini kullanarak RegisterForEventValidation(String, String) olay doğrulaması için kaydedilmiş bir istemci olayını doğrular.
ValidateEvent(String)	yöntemini kullanarak RegisterForEventValidation(String) olay doğrulaması için kaydedilmiş bir istemci olayını doğrular.

Şunlara uygulanır

Ayrıca bkz.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?