ClientScriptManager.IsOnSubmitStatementRegistered Método

  • Referencia

Definición

Espacio de nombres:
System.Web.UI
Ensamblado:
System.Web.dll

Determina si la instrucción OnSubmit se encuentra registrada con el objeto Page.

Sobrecargas

IsOnSubmitStatementRegistered(Type, String)

Determina si la instrucción OnSubmit se encuentra registrada con el objeto Page utilizando la clave y el tipo especificados.
IsOnSubmitStatementRegistered(String)

Determina si la instrucción OnSubmit se encuentra registrada con el objeto Page utilizando la clave especificada.

IsOnSubmitStatementRegistered(Type, String)

Determina si la instrucción OnSubmit se encuentra registrada con el objeto Page utilizando la clave y el tipo especificados.

public:
 bool IsOnSubmitStatementRegistered(Type ^ type, System::String ^ key);
public bool IsOnSubmitStatementRegistered (Type type, string key);
member this.IsOnSubmitStatementRegistered : Type * string -> bool
Public Function IsOnSubmitStatementRegistered (type As Type, key As String) As Boolean

Parámetros

type
Type

Tipo de la instrucción OnSubmit que se va a buscar.

key
String

Clave de la instrucción OnSubmit que se va a buscar.

Devoluciones

Boolean

Es true si la instrucción OnSubmit se encuentra registrada; de lo contrario, es false.

Excepciones

ArgumentNullException

El tipo de instrucción OnSubmit es null.

Ejemplos

En el ejemplo de código siguiente se muestra el uso del IsOnSubmitStatementRegistered método . Se registra un script denominado OnSubmitScript con para Page que cuando se envíe el formulario de la página, se invoca el script.

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

Comentarios

Llame a este método antes de llamar al RegisterOnSubmitStatement método para evitar el registro de instrucciones duplicadas. Esto es especialmente importante si la instrucción requiere una gran cantidad de recursos de servidor para crear.

Una instrucción se identifica de forma única por su clave y su tipo. Las instrucciones con la misma clave y tipo se consideran duplicados. Especifique el tipo basado en el objeto al que se va a acceder al recurso. Por ejemplo, cuando se usa una Page instancia para acceder al recurso, se especifica el Page tipo .

Consulte también

Se aplica a

IsOnSubmitStatementRegistered(String)

Determina si la instrucción OnSubmit se encuentra registrada con el objeto Page utilizando la clave especificada.

public:
 bool IsOnSubmitStatementRegistered(System::String ^ key);
public bool IsOnSubmitStatementRegistered (string key);
member this.IsOnSubmitStatementRegistered : string -> bool
Public Function IsOnSubmitStatementRegistered (key As String) As Boolean

Parámetros

key
String

Clave de la instrucción OnSubmit que se va a buscar.

Devoluciones

Boolean

Es true si la instrucción OnSubmit se encuentra registrada; de lo contrario, es false.

Comentarios

Llame a este método antes de llamar al RegisterOnSubmitStatement método para evitar registrar instrucciones OnSubmit duplicadas. Esto es especialmente importante si la instrucción requiere una gran cantidad de recursos de servidor para crear.

Una instrucción se identifica de forma única por su clave y su tipo. Las instrucciones con la misma clave y tipo se consideran duplicados.

Esta sobrecarga del IsOnSubmitStatementRegistered método llama a la sobrecarga que toma un key parámetro y type con el tipo establecido como un Page objeto

Consulte también

Se aplica a