Partilhar via

ClientScriptManager.IsOnSubmitStatementRegistered Método

  • Referência

Definição

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Determina se a instrução OnSubmit está registrada com o objeto Page.

Sobrecargas

IsOnSubmitStatementRegistered(Type, String)

Determina se a instrução OnSubmit está registrada com o objeto Page usando a chave e o tipo especificados.
IsOnSubmitStatementRegistered(String)

Determina se a instrução OnSubmit está registrada com o objeto Page usando a chave especificada.

IsOnSubmitStatementRegistered(Type, String)

Determina se a instrução OnSubmit está registrada com o objeto Page usando a chave e o 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

O tipo da instrução OnSubmit a ser pesquisada.

key
String

A chave da instrução OnSubmit a ser pesquisada.

Retornos

Boolean

true se a instrução OnSubmit estiver registrada; caso contrário, false.

Exceções

ArgumentNullException

O tipo da instrução OnSubmit é null.

Exemplos

O exemplo de código a seguir demonstra o uso do IsOnSubmitStatementRegistered método. Um script nomeado OnSubmitScript é registrado com o Page modo que, quando o formulário da página é enviado, o script é invocado.

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

Comentários

Chame esse método antes de chamar o RegisterOnSubmitStatement método para evitar o registro de instruções duplicadas. Isso é particularmente importante se a instrução exigir uma grande quantidade de recursos de servidor para criar.

Uma instrução é identificada exclusivamente por sua chave e seu tipo. Instruções com a mesma chave e tipo são consideradas duplicatas. Especifique o tipo com base no objeto que acessará o recurso. Por exemplo, ao usar uma Page instância para acessar o recurso, você especifica o Page tipo.

Confira também

Aplica-se a

IsOnSubmitStatementRegistered(String)

Determina se a instrução OnSubmit está registrada com o objeto Page usando a chave 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

A chave da instrução OnSubmit a ser pesquisada.

Retornos

Boolean

true se a instrução OnSubmit estiver registrada; caso contrário, false.

Comentários

Chame esse método antes de chamar o RegisterOnSubmitStatement método para evitar o registro de instruções OnSubmit duplicadas. Isso é particularmente importante se a instrução exigir uma grande quantidade de recursos de servidor para criar.

Uma instrução é identificada exclusivamente por sua chave e seu tipo. Instruções com a mesma chave e tipo são consideradas duplicatas.

Essa sobrecarga do IsOnSubmitStatementRegistered método chama a sobrecarga que usa um parâmetro e type um key parâmetro com o tipo definido como um Page objeto

Confira também

Aplica-se a