ClientScriptManager.IsOnSubmitStatementRegistered Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI
Assembly:
System.Web.dll

Determina se l'istruzione OnSubmit è registrata con l'oggetto Page.

Overload

IsOnSubmitStatementRegistered(Type, String)

Determina se l'istruzione OnSubmit è stata registrata con l'oggetto Page utilizzando la chiave e il tipo specificati.
IsOnSubmitStatementRegistered(String)

Determina se l'istruzione OnSubmit è stata registrata con l'oggetto Page utilizzando la chiave specificata.

IsOnSubmitStatementRegistered(Type, String)

Determina se l'istruzione OnSubmit è stata registrata con l'oggetto Page utilizzando la chiave e il tipo specificati.

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

Parametri

type
Type

Tipo di istruzione OnSubmit da cercare.

key
String

Chiave dell'istruzione OnSubmit da cercare.

Restituisce

Boolean

true se l'istruzione OnSubmit è registrata; in caso contrario, false.

Eccezioni

ArgumentNullException

Il tipo di istruzione OnSubmit è null.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso IsOnSubmitStatementRegistered del metodo. Uno script denominato OnSubmitScript è registrato con l'oggetto Page in modo che, quando viene richiamato il modulo della pagina, viene richiamato lo 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>

Commenti

Chiamare questo metodo prima di chiamare il RegisterOnSubmitStatement metodo per evitare di registrare istruzioni duplicate. Ciò è particolarmente importante se l'istruzione richiede una grande quantità di risorse server da creare.

Un'istruzione è identificata in modo univoco dalla chiave e dal relativo tipo. Le istruzioni con la stessa chiave e il tipo vengono considerati duplicati. Specificare il tipo in base all'oggetto che accederà alla risorsa. Ad esempio, quando si usa un'istanza Page per accedere alla risorsa, si specifica il Page tipo.

Vedi anche

Si applica a

IsOnSubmitStatementRegistered(String)

Determina se l'istruzione OnSubmit è stata registrata con l'oggetto Page utilizzando la chiave specificata.

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

Parametri

key
String

Chiave dell'istruzione OnSubmit da cercare.

Restituisce

Boolean

true se l'istruzione OnSubmit è registrata; in caso contrario, false.

Commenti

Chiamare questo metodo prima di chiamare il RegisterOnSubmitStatement metodo per evitare di registrare istruzioni OnSubmit duplicate. Ciò è particolarmente importante se l'istruzione richiede una grande quantità di risorse server da creare.

Un'istruzione è identificata in modo univoco dalla chiave e dal relativo tipo. Le istruzioni con la stessa chiave e il tipo vengono considerati duplicati.

Questo overload del IsOnSubmitStatementRegistered metodo chiama l'overload che accetta sia un key parametro che type un parametro con il tipo impostato come Page oggetto

Vedi anche

Si applica a