Bearbeiten von Ereignissen mit Skripten
Dieses Dokument beschreibt die grundlegenden Prinzipien des „Skripten“ was zum Bearbeiten von Berichten, den Bändern und Elementen angewendet werden kann.
Dieses Dokument beinhaltet folgende Sektionen:
• Skripten Überblick
• Skripten Einzelheiten
Skripten Überblick
Skripte sind Programmkommandos die im Ereignis bearbeiten des Berichtselements platziert werden. Wenn das definierte Ereignis auftritt (z. B. ein Mausklick), wird der Skriptcode gestartet.
Sie können Skripte für einen Bericht oder jedes seiner Elemente (Bänder oder Kontrollelemente) schreiben, welche ausgeführt werden, wenn der Bericht angeschaut, gedruckt oder exportiert wird.
Obwohl der Bericht Designer praktisch jede Aufgabe ohne Skripten bearbeiten kann (bedingtes Ändern der Elementdarstellung, Bedingtes Ändern von Labeltexten und bedingtes verstecken von Bändern) gibt es die Möglichkeit zum Skripten, um die Standartfunktionalität so weit wie nötig zu erweitern. Außerdem ist Skripten die einzige Möglichkeit, um personalisierte
Zusammenfassungen zu berechnen (dies wird detailliert im letzten Teil dieses Dokuments beschrieben).
Jedes Berichtselement hat einen Satz von Skriptereignissen, die individuell für jeden
Elementtyp sind. Beispielsweise sind die Ereignisse für das Detailband im nebenstehenden Bild
dargestellt.
Nachdem Sie „neu“ für ein Event geklickt haben (z. B. vorm Drucken, welches am meisten genutzt wird), wird der Skript Tab aktiviert, wo Sie alle Skripts des Berichts verwalten und bearbeiten können.
In diesem Tab wird automatisch eine Skriptvorlage für das ausgewählte Ereignis in der Sprache hinzugefügt, die über die Skriptsprache Eigenschaft des Berichts festgelegt wurde.
Sie können testen, ob Ihre Skripte gültig sind, indem Sie validieren klicken. Das Prüfergebnis
wird dann im Skript Fehler Panel angezeigt.
Bedenken Sie, dass Skripte neben dem Layout in einer Datei gespeichert werden (für Details hierzu, siehe Speichern des aktuellen Layouts vorm Bearbeiten).
Skript Einzelheiten
- 1. Skriptsprache
Die Skripte können in einer der folgenden Programmiersprachen geschrieben werden, welche das .NET Framework unterstützen – C#, Visual Basic und J#. Da J# nicht standardmäßig mit dem Framework installiert wird, gehen Sie sicher, dass es vorhanden ist, bevor Sie einen Code in der Sprache schreiben. Die Programmiersprache wird über die Namensgleiche Eigenschaft des Bericht Objekts festgelegt. Standardmäßig ist es auf C# eingestellt.
- 2. Skript Möglichkeiten
Skripte können auf folgendem Weg ausgeführt werden:
Die Berichtsmaschine generiert eine temporäre Klasse. Die Namen der Variablen werden über die Name Eigenschaft der Kontrollelemente und Objekte welche sie repräsentieren definiert. Wenn das Skript vor verarbeitet wird, werden seine Namespace Richtlinien aus dem Skript ausgeschnitten und dem Namespace hinzugefügt, wo die temporäre Klasse definiert ist. Nach dem Vorverarbeiten werden alle Skripte im Code der temporären Klasse platziert. Die resultierende Klasse wird anschließend im Speicher kompiliert und die Methoden werden abgerufen, wenn Ereignisse auftreten.
- 3. Zusammensetzung externer Konstruktionen
Die Skriptreferenzen Eigenschaft von der Bericht Eigenschaft spezifiziert den ganzen Pfad (inklusive der Dateinamen) zu den Zusammensetzungen auf welche, in dem Skript des Berichts verwiesen wird. Dieser Pfad sollte für alle Zusammensetzungen
spezifiziert werden welche im Skript durch Nutzen, Importieren, oder Import, Richtlinien mit inbegriffen werden.
Hinweis: Normalerweise müssen Sie keine Zusammensetzungen mit einbeziehen, weil die meisten Standard Zusammensetzungen, die Sie eventuell in Skripten benötigen würden, bereits im Bericht Designer vorhanden sind.
Siehe auch: