ClientScriptManager.RegisterOnSubmitStatement(Type, String, String) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
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 script
RegisterOnSubmitStatement 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).