• Artikel

Klassenbibliotheken für ein benutzerdefiniertes Berichtselement

Benutzerdefinierte Berichtselemente verwenden Klassen vom 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. Weitere Informationen zu einem Codebeispiel für die Verwendung dieser Klassen finden Sie unter SQL Server Reporting Services Product Samples.

Infrastrukturklassen eines benutzerdefinierten Berichtselements

Die folgenden Klassen werden zum Implementieren eines benutzerdefinierten Berichtselements verwendet.

HinweisHinweis

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

Eine Microsoft.ReportingServices.ReportRendering.CustomReportItem.CustomData-Klasse, die 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

ISite von component.

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.