Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método ClientScriptManager.RegisterOnSubmitStatement (Type, String, String)

 

Publicado: octubre de 2016

Registra una instrucción OnSubmit con el Page objeto utilizando un tipo, una clave y un literal de script. La instrucción ejecuta cuando el HtmlForm se envía.

Espacio de nombres:   System.Web.UI
Ensamblado:  System.Web (en System.Web.dll)

public void RegisterOnSubmitStatement(
	Type type,
	string key,
	string script
)

Parámetros

type
Type: System.Type

El tipo de la instrucción OnSubmit que se va a registrar.

key
Type: System.String

La clave de la instrucción OnSubmit que se va a registrar.

script
Type: System.String

Literal de script de la instrucción OnSubmit que se va a registrar.

Exception Condition
ArgumentNullException

El valor de type es null.

Una instrucción OnSubmit se identifica mediante su clave y su tipo. Instrucciones con la misma clave y tipo se consideran duplicadas. Una sola instrucción con un par de clave y un tipo determinado se puede registrar con la página. Al intentar registrar una instrucción que ya está registrada, no creará un duplicado de la instrucción.

Llame a la IsOnSubmitStatementRegistered método para determinar si una instrucción OnSubmit ya está registrada con un par de clave y un tipo determinado y evitar innecesariamente agregar la secuencia de comandos.

El script parámetro de la RegisterOnSubmitStatement método puede contener varios comandos de script mientras están correctamente delimitadas con un punto y coma (;).

El RegisterOnSubmitStatement agrega un script que se ejecuta antes de enviar la página y le da la oportunidad de cancelar el envío.

Para obtener más información sobre los formularios HTML y el OnSubmit de atributo, vea la World Wide Web Consortium (W3C) Web site.

En el ejemplo de código siguiente se muestra el uso de la RegisterOnSubmitStatement (método).

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

.NET Framework
Disponible desde 2.0
Volver al principio
Mostrar: