Mithilfe des Connectorcodes für einen .NETInput-Knoten können Informationen zur lokalen Umgebung hinzugefügt werden.
Bei der Entwicklung für einen .NETInput-Knoten kann der Inhalt der lokalen Umgebung aus dem Connectorcode für den .NETInput-Knoten heraus gefüllt werden, während die einzelnen Nachrichten erstellt werden. Die aktualisierte lokale Umgebung ermöglicht die Speicherung von Metadaten zu einem bestimmten Event (Ereignis) oder PollingResult (Abfrageergebnis), damit sie von späteren Knoten im Nachrichtenfluss verwendet werden können.
Die Daten werden standardmäßig in einem Abschnitt der lokalen Umgebung mit dem Namen DotNet abgelegt. Unter DotNet in der Ordnerstruktur befindet sich ein Ordner namens Input. Sie können weitere Ordner und Elemente unter dem Ordner Input erstellen.
Sie können den Namen des DotNet-Ordners der höchsten Ebene ändern, indem Sie die Eigenschaft Name der Factory aus den Methoden Constructor(), Initialize() oder Start() des Connectors heraus festlegen.
Der Name des Ordners Input kann nicht geändert werden.
Um Ordner und Elemente unter dem Ordner Input umzubenennen, müssen Sie die Methode BuildProperties für eine Unterklasse von NBPollingResult oder NBByteArrayPollingResult überschreiben. Geben Sie in dieser Methode ein Wörterbuch zurück, das mit Schlüsseln und Werten gefüllt ist, die zu Name- oder NameValue-Elementen unter dem Ordner Input werden. Wenn der Schlüssel aus mehreren Teilen besteht, die durch das Zeichen / getrennt sind, wird eine Baumstruktur für die lokale Umgebung erstellt, wie sie in den folgenden Codebeispielen gezeigt wird.
Das folgende Codefragment stammt aus einer benutzerdefinierten NBPollingResult-Unterklasse:
public override Dictionary<Zeichenfolge, Zeichenfolge> BuildProperties()
{
var result = new Dictionary<Zeichenfolge, Zeichenfolge>();
result.Add("a/b/c/d", "Hello");
result.Add("a/e/f", "World!");
return result;
}
Dieser Code erstellt eine Baumstruktur für die lokale Umgebung, die wie folgt aussieht:
(0x01000000:Name):DotNet = (
(0x01000000:Name):Input = (
(0x01000000:Name):a = (
(0x01000000:Name):b = (
(0x01000000:Name):c = (
(0x03000000:NameValue):d = 'Hello' (CHARACTER)
)
)
(0x01000000:Name):e = (
(0x03000000:NameValue):f = 'World!' (CHARACTER)
)
)
)
)
Das nächste Codefragment zeigt, wie der Name des DotNet-Ordners auf der höchsten Ebene in den Namen MyConnectorFactory umbenannt wird:
public override void Initialize()
{
NBConnectorFactory factory = ConnectorFactory;
factory.Name = "MyConnectorFactory";
//Weiterer Code. }