Classe XmlEvents

Articolo
04/27/2010

Insieme di tutti gli eventi XmlEvent per un modello di modulo.

Spazio dei nomi: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Sintassi

<DefaultMemberAttribute("Item")> _
Public MustInherit Class XmlEvents

Dim instance As XmlEvents

[DefaultMemberAttribute("Item")] 
public abstract class XmlEvents

Osservazioni

L'insieme XmlEvents e la classe XmlEvent sono utilizzati per associare un evento a livello di documento, ad esempio l'evento Changed per un campo o un gruppo nel documento XML sottostante di un modulo, a un gestore eventi nel metodo InternalStartup all'inizio della classe FormCode in un modello di modulo in codice gestito. In fase di esecuzione, il metodo InternalStartup viene eseguito quando il modello di modulo viene aperto per inizializzare l'associazione di tutti i gestori eventi.

Importante:
Il metodo InternalStartup e il codice di associazione degli eventi interno a esso vengono generati da InfoPath quando si aggiungono gestori eventi utilizzando diversi comandi dell'interfaccia utente. Evitare di creare il metodo InternalStartup o di scrivere codice aggiuntivo interno al metodo manualmente. Per informazioni su come aggiungere gestori eventi utilizzando i comandi dell'interfaccia utente, vedere Procedura: Aggiungere un gestore eventi.

Il metodo InternalStartup e il codice di associazione degli eventi interno a esso vengono generati da InfoPath quando si aggiungono gestori eventi utilizzando diversi comandi dell'interfaccia utente. Evitare di creare il metodo InternalStartup o di scrivere codice aggiuntivo interno al metodo manualmente. Per informazioni su come aggiungere gestori eventi utilizzando i comandi dell'interfaccia utente, vedere Procedura: Aggiungere un gestore eventi.

Esempio

Nell'esempio seguente viene illustrato il codice generato da InfoPath nel metodo InternalStartup per associare il gestore eventi per un evento Validating associato a un campo nel documento XML sottostante del modulo tramite la proprietà XmlEvents.Item(String) della classe XmlEvents. Viene inoltre illustrato il codice generato per l'evento Changed di un campo associato alla colonna CategoryName di un'origine dati secondaria denominata Categories tramite la proprietà XmlEvents.Item(String,String) della classe XmlEvents.

public void InternalStartup()
{
   EventManager.XmlEvents["/my:myFields/my:field1"].Validating 
      += new XmlChangedEventHandler(field1_Validating);
   EventManager.XmlEvents[
      "/dfs:myFields/dfs:dataFields/d:Categories/@CategoryName", 
      "Categories"].Changed 
      += new XmlChangedEventHandler(
      Categories__CategoryName_attr_Changed);
}

Private Sub InternalStartup(ByVal sender As Object, _
   ByVal e As EventArgs) Handles Me.Startup
   AddHandler EventManager.XmlEvents( _
      "/my:myFields/my:field1").Validating, _
      AddressOf field2_Validating
   AddHandler EventManager.XmlEvents( _
      "/dfs:myFields/dfs:dataFields/d:Categories/@CategoryName", _
      "Categories").Changed, _
      AddressOf Categories__CategoryName_attr_Changed
End Sub

Gerarchia di ereditarietà

System.Object
Microsoft.Office.InfoPath.XmlEvents

Thread Safety

Tutti i membri statici pubblici (Shared in Visual Basic) di questo tipo sono thread-safe. I membri di istanza non sono garantiti come thread-safe.

Vedere anche

Riferimenti

Membri XmlEvents
Spazio dei nomi Microsoft.Office.InfoPath

Condividi tramite