Sdílet prostřednictvím

ClientScriptManager.RegisterOnSubmitStatement(Type, String, String) Metoda

  • Reference

Definice

Obor názvů:
System.Web.UI
Sestavení:
System.Web.dll

Zaregistruje příkaz OnSubmit s objektem Page pomocí typu, klíče a literálu skriptu. Příkaz se spustí při HtmlForm odeslání příkazu.

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)

Parametry

type
Type

Typ příkazu OnSubmit, který se má zaregistrovat.

key
String

Klíč příkazu OnSubmit k registraci.

script
String

Literál skriptu příkazu OnSubmit, který se má zaregistrovat.

Výjimky

ArgumentNullException

type je null.

Příklady

Následující příklad kódu ukazuje použití RegisterOnSubmitStatement metody.

<%@ 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>

Poznámky

Příkaz OnSubmit je jedinečně identifikován svým klíčem a typem. Příkazy se stejným klíčem a typem se považují za duplicitní. Na stránce je možné zaregistrovat pouze jeden příkaz s daným typem a párem klíčů. Pokus o registraci příkazu, který je již zaregistrován, nevytvoří duplikát příkazu.

Voláním IsOnSubmitStatementRegistered metody určete, zda je příkaz OnSubmit již zaregistrovaný v dané dvojici klíč a typ, a vyhněte se zbytečnému pokusu o přidání skriptu.

Parametr scriptRegisterOnSubmitStatement metody může obsahovat více příkazů skriptu, pokud jsou správně odděleny středníkem (;).

Přidá RegisterOnSubmitStatement skript, který se spustí před odesláním stránky a umožní vám zrušit odeslání.

Další informace o formulářích HTML a atributu OnSubmit naleznete na webu W3C (World Wide Web Consortium).

Platí pro

Viz také