Referenzierung zu Datenquellen

Im Gegensatz zu den Ausdrücken in FastReport (im Abschnitt "Ausdrücke" behandelt) werden hier im Skript niemals eckige Klammern zur Referenzierung der Datenquelle genutzt. Anstelle dessen wird die Methode GetColumnValue des Berichtsobjektes, das den Spaltenwert zurückgibt, genutzt:

string productName = (string)Report.GetColumnValue("Products.Name");

Hier lässt sich erkennen, dass der Name der Quelle und seine Spalte angegeben werden muss. Im Fall kann der Quellname ein Verbund sein, wenn wir zur Datenuelle durch Nutzung einer Relation referenzieren. Detaillierte Informationen über Beziehungen sind im Kapitel "Daten" erläutert. Zu einer Spalte der verwandten Datenquelle kann beispielsweise auf diese Art referenziert werden:

string categoryName = (string)Report.GetColumnValue("Products.Categories.CategoryName");

Zu Vereinfachung wird das Fenster "Daten" genutzt. Aus diesem lassen sich die Datenelemente in das Skript ziehen. FastReport erstellt automatisch einen Code der auf das Element verweist.

Zur Referenzierung auf die Datenquelle selbst wird die Methode GetDataSource des Berichtsobjektes genutzt:

DataSourceBase ds = Report.GetDataSource("Products");

Hilfe zu Eigenschaften und Methoden der Klasse DataSourceBase kann über das Fastreport.Net Klassenreferenz Hilfesystem abgerufen werden. In der Regel wir dieses Objekt im Skript auf folgende Art genutzt:

// get a reference to the data source
DataSourceBase ds = Report.GetDataSource("Products");
// initialize it
ds.Init();
// enum all rows
while (ds.HasMoreRows)
{
  // get the data column value from the current row
  string productName = (string)Report.GetColumnValue("Products.Name");
  // do something with it...
  // ...
  // go next data row
  ds.Next();
}