XmlForm.FormState-Eigenschaft

Ruft einen Verweis auf eine Eigenschaftensammlung vom Typ System.Collections.IDictionary ab, der von browserfähigen Formularen zum Beibehalten von Statusinformationen in allen Sitzungen auf dem Server verwendet werden kann.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

Public MustOverride ReadOnly Property FormState As IDictionary

Dim instance As XmlForm
Dim value As IDictionary

value = instance.FormState

public abstract IDictionary FormState { get; }

Eigenschaftswert

IDictionary mit sämtlichen benutzerdefinierten Statusvariablen, die im Deklarationsabschnitt des Formularcodes definiert wurden.

Hinweise

Auf den Member kann uneingeschränkt zugegriffen werden.

Auf diesen Typ oder diesen Member kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft Office InfoPath 2007 oder einem Webbrowser geöffnet wurden.

Beispiel

Das folgende Beispiel zeigt ein Entwurfsmuster zum Erstellen einer als Zähler dienenden Statusvariablen im Deklarationsabschnitt der FormCode-Klasse (vor der InternalStartup-Methode). Dieses Beispiel überprüft vor der Wertrückgabe, ob die Zählervariable den Wert null aufweist, um Fehler, bei denen das FormState-Array nicht initialisiert wird, zu umgehen.

private int _Counter
{
   get
   {
      if(FormState["_Counter"] != null)
      {
         return (int) FormState["_Counter"];
      }
      else
      {
         return 0;
      }
   }
   set
   {
      FormState["_Counter"] = value;
   }
}

Private Property _Counter As Integer
   Get
      If(FormState("_Counter") != null) Then
         _Counter = DirectCast(FormState("_Counter"), Integer)
      Else
         _Counter = 0
      End If
   End Get
   Set
      FormState("_Counter") = value
   End Set
End Property

Siehe auch

Referenz

XmlForm-Klasse
XmlForm-Member
Microsoft.Office.InfoPath-Namespace