Aracılığıyla paylaş

ClientScriptManager.RegisterOnSubmitStatement(Type, String, String) Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI
Bütünleştirilmiş Kod:
System.Web.dll

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.

public:
 void RegisterOnSubmitStatement(Type ^ type, System::String ^ key, System::String ^ script);
public void RegisterOnSubmitStatement (Type type, string key, string script);
member this.RegisterOnSubmitStatement : Type * string * string -> unit
Public Sub RegisterOnSubmitStatement (type As Type, key As String, script As String)

Parametreler

type
Type

Kaydedilecek OnSubmit deyiminin türü.

key
String

OnSubmit deyiminin kaydedilecek anahtarı.

script
String

Kaydedilecek OnSubmit deyiminin betik değişmez değeri.

Özel durumlar

ArgumentNullException

type, null değeridir.

Örnekler

Aşağıdaki kod örneği yönteminin RegisterOnSubmitStatement kullanımını gösterir.

<%@ 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 script on the page.
    String csname = "OnSubmitScript";
    Type cstype = this.GetType();
        
    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;

    // Check to see if the OnSubmit statement is already registered.
    if (!cs.IsOnSubmitStatementRegistered(cstype, csname))
    {
      String cstext = "document.write('Text from OnSubmit statement');";
      cs.RegisterOnSubmitStatement(cstype, csname, cstext);
    }

  }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form    id="Form1"
            runat="server">
     <input type="submit"
            value="Submit" />
     </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 script on the page.
    Dim csname As String = "OnSubmitScript"
    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 OnSubmit statement is already registered.
    If (Not cs.IsOnSubmitStatementRegistered(cstype, csname)) Then
      
      Dim cstext As String = "document.write('Text from OnSubmit statement.');"
      cs.RegisterOnSubmitStatement(cstype, csname, cstext)
      
    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="submit"
            value="Submit" />
     </form>
  </body>
</html>

Açıklamalar

OnSubmit deyimi, anahtarı ve türüyle benzersiz olarak tanımlanır. Aynı anahtara ve türe sahip deyimler yinelenen olarak kabul edilir. Belirli bir türe ve anahtar çifte sahip yalnızca bir deyim sayfaya kaydedilebilir. Zaten kayıtlı olan bir deyimi kaydetmeye çalışmak deyimin bir yinelemesini oluşturmaz.

Bir OnSubmit deyiminin IsOnSubmitStatementRegistered belirli bir anahtar ve tür çiftiyle zaten kayıtlı olup olmadığını belirlemek için yöntemini çağırın ve gereksiz yere betiği eklemeye çalışmaktan kaçının.

script yönteminin RegisterOnSubmitStatement parametresi, noktalı virgülle (;)) düzgün şekilde sınırlandırıldıkları sürece birden çok betik komutu içerebilir.

, RegisterOnSubmitStatement sayfa gönderilmeden önce yürütülen bir betik ekler ve size gönderimi iptal etme fırsatı verir.

HTML formları ve OnSubmit özniteliği hakkında daha fazla bilgi için World Wide Web Consortium (W3C) Web sitesine bakın.

Şunlara uygulanır

Ayrıca bkz.