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
'Declaration
Public MustOverride ReadOnly Property FormState As IDictionary
Get
'Usage
Dim instance As XmlForm
Dim value As IDictionary
value = instance.FormState
public abstract IDictionary FormState { get; }
Eigenschaftswert
Typ: System.Collections.IDictionary
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 InfoPath Filler oder einem Webbrowser geöffnet wurden.
Beispiele
Das folgende Codebeispiel zeigt ein Entwurfsmuster zum Erstellen einer als Zähler dienenden Statusvariablen im Deklarationsabschnitt der FormCode-Klasse (vor der InternalStartup-Methode). Der Code überprüft vor der Wertrückgabe, ob die Zählervariable den Wert ein Nullverweis (Nothing in Visual Basic) hat, um Fehler bei ausbleibender Initialisierung des FormState-Arrays 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