Benutzerdefinierte Berichtselementklassenbibliotheken
Benutzerdefinierte Berichtselemente verwenden Klassen des Microsoft.ReportDesigner-Namespaces. Die Klassen, die zum Implementieren eines benutzerdefinierten Berichtselements verwendet werden, können in zwei Hauptkategorien gruppiert werden: eindeutige Klassen zur Unterstützung der Infrastruktur eines benutzerdefinierten Berichtselements und verwaltete Wrapperklassen, die die Funktionalität von relevanten RDL-Elementen (Report Definition Language) kapseln. Ein Codebeispiel für die Verwendung dieser Klassen finden Sie unter SQL Server Reporting Services-Produktbeispiele.
Benutzerdefinierte Berichtselementinfrastrukturklassen
Die folgenden Klassen werden zum Implementieren eines benutzerdefinierten Berichtselements verwendet.
Hinweis
Die nachfolgenden Tabellen stellen keine vollständige Liste dar. Sie enthalten nur die am häufigsten verwendeten Eigenschaften und Methoden für jede Klasse.
Microsoft.ReportDesigner.CustomReportItemDesigner
Microsoft.ReportDesigner.CustomReportItemDesigner ist die Hauptklasse des benutzerdefinierten Berichtselements. Die Hauptklasse der Implementierung eines benutzerdefinierten Berichtselements muss von dieser Klasse erben.
Öffentliche Eigenschaften
| Eigenschaft | Beschreibung |
|---|---|
| Name | Der Name des benutzerdefinierten Berichtselements. |
| Type | Der Typ des benutzerdefinierten Berichtselements. |
| CustomData | Ein CustomData-Objekt, das die während der Entwurfszeit angegebenen Dateneigenschaften für ein benutzerdefiniertes Berichtselement kapselt. |
| CustomProperties | Eine Auflistung benutzerdefinierter Eigenschaften für das benutzerdefinierte Berichtselement. |
| Height | Die Höhe der Steuerung für ein benutzerdefiniertes Berichtselement. |
| Width | Die Breite der Steuerung für ein benutzerdefiniertes Berichtselement. |
| Report | Ein Container für die Eigenschaften auf Berichtsebene, z. B. die Liste der Datasets in dem Bericht. |
| AltReportItem | Das alternative Berichtselementobjekt, das verwendet werden soll, wenn das Laufzeitsteuerelement des benutzerdefinierten Berichtselements nicht unterstützt wird. |
| Stil | Die Stileigenschaften für das benutzerdefinierte Berichtselement. |
| Adornment | Ein Gestaltungsfenster für die interaktive Bearbeitung der Steuerung. |
| Website | Die ISite der Komponente. |
| DesignerVerbCollection | Ein Array von benutzerdefinierten Verben für das Kontextmenü der Steuerung. |
Öffentliche Methoden
| Methode | BESCHREIBUNG |
|---|---|
| BeginEdit | Aktiviert die interaktive Bearbeitung der Steuerung. |
| DoDefaultAction | Wird als Reaktion auf das Doppelklicken oder Drücken der EINGABETASTE auf der Steuerung aufgerufen. |
| EndEdit | Deaktiviert die interaktive Bearbeitung der Steuerung. |
| GetService | Gibt ein Objekt zurück, das einen Dienst darstellt. |
| InitializeNewComponent | Wird aufgerufen, wenn ein neues benutzerdefiniertes Berichtselement erstellt wird. |
| Invalidate | Zeichnet die gesamte Oberfläche der Steuerung neu. |
| OnDragEnter OnDragDrop |
Wird aufgerufen, wenn ein Objekt auf die Steuerung gezogen wird. |
| OnPaint | Wird als Reaktion auf das Paint-Ereignis aufgerufen. |
Microsoft.ReportDesigner.CustomReportItemAttribute
Microsoft.ReportDesigner.CustomReportItemAttribute ist das Attribut, das zum Identifizieren des Typs des benutzerdefinierten Berichtselements verwendet wird. Der Name muss dem Wert des <Name>-Attributs des ReportItem-Elements in der Konfigurationsdatei des Berichts-Designers entsprechen.
Öffentliche Methoden
| Methode | BESCHREIBUNG |
|---|---|
| CustomReportItemAttribute | Erstellt das CustomReportItemAttribute-Objekt. |
Microsoft.ReportDesigner.LocalizedNameAttribute
Microsoft.ReportDesigner.LocalizedNameAttribute ist das Attribut, das zum Angeben des Anzeigenamens verwendet wird, der für den benutzerdefinierten Berichtselement-Designer verwendet werden soll.
Öffentliche Methoden
| Methode | BESCHREIBUNG |
|---|---|
| LocalizedNameAttribute | Erstellt das LocalizedNameAttribute-Objekt. |
Microsoft.ReportDesigner.Adornment
Die Adornment-Klasse wird von der Entwurfszeitkomponente eines benutzerdefinierten Berichtselements verwendet, um Bereiche außerhalb des Hauptrechtecks der Entwurfsoberfläche bereitzustellen. Diese Bereiche behandeln Benutzeroberflächenereignisse wie Mausklicks und Drag und Drop-Vorgänge.
Öffentliche Methoden
| Methode | BESCHREIBUNG |
|---|---|
| OnShow | Wird aufgerufen, wenn Adornment aktiviert wird. |
| OnHide | Wird aufgerufen, wenn Adornment deaktiviert wird. |
| Farbe | Wird als Reaktion auf das Paint-Ereignis aufgerufen. |
| OnDragEnter OnDragOver OnDragLeave OnDragDrop |
Wird aufgerufen, wenn ein Objekt in Adornment gezogen wird. |
Microsoft.ReportDesigner.AdornerService
Diese Klasse wird zum Bereitstellen einer Auflistung von Anzeigediensten verwendet, die vom benutzerdefinierten Berichtselement zum Unterstützen von Adornment-Objekten für die Entwurfszeitkomponente eines benutzerdefinierten Berichtselements genutzt werden.
Öffentliche Eigenschaften
| Eigenschaft | BESCHREIBUNG |
|---|---|
| AdornerWindowBounds | Die Begrenzungen des Gestaltungsfensters. |
| AdornerWindowRegion | Der Bereich des Gestaltungsfensters. |
| AdornerWindowGraphics | Ein Grafikontext für das Gestaltungsfenster. |
Öffentliche Methoden
| Methode | BESCHREIBUNG |
|---|---|
| ComponentRectInDesignerFrame | Gibt die Begrenzungen der Komponente zurück, die in Designerrahmenkoordinaten umgewandelt wurden. |
| InvalidateAdorner | Führt dazu, dass das Gestaltungsfenster ungültig wird. |
| PointToAdorner | Gibt einen Punkt in Bildschirmkoordinaten zurück, der in Gestaltungsfensterkoordinaten umgewandelt wurde. |
Microsoft.ReportDesigner.ExpressionEditor
Diese Klasse kann von der Entwurfszeitsteuerung eines benutzerdefinierten Berichtselements verwendet werden, um den Ausdrucks-Editor aufzurufen.
Öffentliche Methoden
| Methode | BESCHREIBUNG |
|---|---|
| EditValue | Ruft den mit dem angegebenen Objektwert initialisierten Ausdrucks-Editor auf. |
Microsoft.ReportDesigner.IFieldsDataObject
Diese Klasse ist eine Sammlung von Reporting Services-Feldern und wird zum Unterstützen von Drag & Drop-Vorgängen in der Entwurfsumgebung verwendet. Erbt von IReportItemDataObject.
Öffentliche Eigenschaften
| Eigenschaft | BESCHREIBUNG |
|---|---|
| DataSetName | Der Name des Datasets mit den Feldern, die abgelegt werden soll. |
| Fields | Die Auflistung von Feldern (Microsoft.ReportDesigner.Field), die abgelegt werden sollen. |