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 Standard benutzerdefinierte Berichtselementklasse. 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.

Zugehöriger Inhalt

Berichtsdefinitionssprache (Report Definition Language, RDL) (SSRS)
Erstellen einer benutzerdefinierten Berichtselement-Laufzeitkomponente
Erstellen einer benutzerdefinierten Berichtselement-Entwurfszeitkomponente