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 dieses Mitglied kann uneingeschränkt zugegriffen werden.
Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in 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