Klassenbibliotheken für ein benutzerdefiniertes Berichtselement

Benutzerdefinierte Berichtselemente verwenden Klassen aus dem Microsoft.ReportDesigner-Namespace. 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.

Infrastrukturklassen eines benutzerdefinierten Berichtselements

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

Dies ist die Hauptklasse eines benutzerdefinierten Berichtselements. Die Hauptklasse der Implementierung eines benutzerdefinierten Berichtselements muss von dieser Klasse erben.

Öffentliche Eigenschaften

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 muss, wenn die Laufzeitsteuerung für das benutzerdefinierte Berichtselement nicht unterstützt wird.
Style	Die Stileigenschaften für das benutzerdefinierte Berichtselement.
Adornment	Ein Gestaltungsfenster für die interaktive Bearbeitung der Steuerung.
Site	Die ISite der Komponente.
DesignerVerbCollection	Ein Array der benutzerdefinierten Verben für das Kontextmenü der Steuerung.

Öffentliche Methoden

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

Dieses Attribut wird zur Identifizierung des Typs des benutzerdefinierten Berichtselements verwendet. Der Name muss dem Wert des <Name>-Attributs des ReportItem-Elements in der Konfigurationsdatei des Berichts-Designers entsprechen.

Öffentliche Methoden

CustomReportItemAttribute

Erstellt das CustomReportItemAttribute-Objekt.

Microsoft.ReportDesigner.LocalizedNameAttribute

Dieses Attribut wird zum Festlegen des Anzeigenamens für den Designer des benutzerdefinierten Berichtselements verwendet.

Öffentliche Methoden

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

OnShow	Wird aufgerufen, wenn Adornment aktiviert wird.
OnHide	Wird aufgerufen, wenn Adornment deaktiviert wird.
Paint	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

AdornerWindowBounds	Die Begrenzungen des Gestaltungsfensters.
AdornerWindowRegion	Der Bereich des Gestaltungsfensters.
AdornerWindowGraphics	Ein Grafikontext für das Gestaltungsfenster.

Öffentliche Methoden

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

EditValue

Ruft den mit dem angegebenen Objektwert initialisierten Ausdrucks-Editor auf.

Microsoft.ReportDesigner.IFieldsDataObject

Diese Klasse ist eine Auflistung von Reporting Services-Feldern und wird zum Unterstützen von Drag und Drop-Vorgängen in der Entwurfsumgebung verwendet. Sie erbt von IReportItemDataObject.

Öffentliche Eigenschaften

DataSetName	Der Name des Datasets mit den Feldern, die abgelegt werden soll.
Fields	Die Auflistung von Feldern (Microsoft.ReportDesigner.Field), die abgelegt werden sollen.

Siehe auch

Konzepte

Berichtsdefinitionssprache (Report Definition Language, RDL) (SSRS)

Erstellen einer Laufzeitkomponente für ein benutzerdefiniertes Berichtselement

Erstellen einer Entwurfszeitkomponente für ein benutzerdefiniertes Berichtselement