Librerie di classi dell'elemento del report personalizzatoCustom Report Item Class Libraries

Gli elementi del report personalizzati usano le classi dello spazio dei nomi Microsoft.ReportDesigner.Custom report items use classes from the Microsoft.ReportDesigner namespace. Le classi utilizzate per implementare un elemento del report personalizzato possono essere suddivise in due categorie principali: le classi univoche progettate per supportare l'infrastruttura dell'elemento del report personalizzato e le classi wrapper gestite che incapsulano la funzionalità degli elementi RDL (Report Definition Language) rilevanti.The classes used to implement a custom report item can be grouped into two main categories: unique classes designed to support custom report item infrastructure, and managed wrapper classes that encapsulate the functionality of relevant Report Definition Language (RDL) elements. Per un esempio di codice sull'uso di queste classi, vedere SQL Server Reporting Services Product Samples (Esempi del prodotto SQL Server Reporting Services).For a code sample on how to use these classes, see SQL Server Reporting Services Product Samples.

Classi di infrastruttura dell'elemento del report personalizzatoCustom Report Item Infrastructure Classes

Le classi riportate di seguito vengono utilizzate per implementare un elemento del report personalizzato.The following classes are used to implement a custom report item.

Nota

Nelle tabelle seguenti non vengono forniti elenchi completi, ma solo le proprietà e i metodi utilizzati più di frequente per ciascuna classe.The following tables are not complete listings; they include only the most commonly used properties and methods for each class.

Microsoft.ReportDesigner.CustomReportItemDesignerMicrosoft.ReportDesigner.CustomReportItemDesigner

È la classe principale dell'elemento del report personalizzato.This is the main custom report item class. La classe principale dell'implementazione dell'elemento del report personalizzato deve ereditare da questa classe.The main class of your custom report item implementation must inherit from this class.

Proprietà pubblichePublic Properties

NomeName Nome dell'elemento del report personalizzato.The name of the custom report item.
TipoType Tipo di elemento del report personalizzato.The type of the custom report item.
CustomDataCustomData Oggetto CustomData che incapsula le proprietà dei dati dell'elemento del report personalizzato specificate in fase di progettazione.A CustomData object that encapsulates the custom report item data properties specified at design time.
CustomPropertiesCustomProperties Raccolta di proprietà personalizzate per l'elemento del report personalizzato.A collection of custom properties for the custom report item.
HeightHeight Altezza del controllo dell'elemento del report personalizzato.The height of the custom report item control.
WidthWidth Larghezza del controllo dell'elemento del report personalizzato.The width of the custom report item control.
ReportReport Contenitore per le proprietà a livello di report, ad esempio l'elenco dei set di dati nel report.A container for the report-level properties, such as the list of datasets in the report.
AltReportItemAltReportItem Oggetto elemento del report alternativo, da utilizzare se il controllo di runtime di un elemento del report personalizzato non è supportato.The alternate report item object, to be used where the custom report item run-time control is not supported.
StileStyle Proprietà di stile per l'elemento del report personalizzato.The style properties for the custom report item.
AdornmentAdornment Finestra dell'area di controllo utilizzata per la modifica interattiva del controllo.An adornment window used for interactive editing of the control.
SiteSite Interfaccia ISite del componente.The ISite of the component.
DesignerVerbCollectionDesignerVerbCollection Matrice di verbi personalizzati per il menu di scelta rapida del controllo.An array of custom verbs for the control’s shortcut menu.

Metodi pubbliciPublic Methods

BeginEditBeginEdit Attiva la modifica interattiva per il controllo.Activates interactive editing for the control.
DoDefaultActionDoDefaultAction Viene chiamato quando si fa doppio clic o si preme Invio sul controllo.Called in response to double-clicking or pressing Return on the control.
EndEditEndEdit Disattiva la modifica interattiva per il controllo.Deactivates interactive editing for the control.
GetServiceGetService Restituisce un oggetto che rappresenta un servizio.Returns an object which represents a service.
InitializeNewComponentInitializeNewComponent Viene chiamato quando si crea un nuovo elemento del report personalizzato.Called when a new custom report item is created.
InvalidateInvalidate Ridisegna l'intera superficie del controllo.Repaints the entire surface of the control.
OnDragEnterOnDragEnter

OnDragDropOnDragDrop
Viene chiamato quando si trascina un oggetto sul controllo.Called when an object is dragged onto the control.
OnPaintOnPaint Viene chiamato in risposta all'evento Paint.Called in response to the Paint event.

Microsoft.ReportDesigner.CustomReportItemAttributeMicrosoft.ReportDesigner.CustomReportItemAttribute

Attributo utilizzato per identificare il tipo di elemento del report personalizzato.This is the attribute used to identify the type of the custom report item. Il nome deve corrispondere al valore dell'attributo <Name> dell'elemento ReportItem nel file di configurazione di Progettazione report.The name must match the value of the <Name> attribute of the ReportItem element in the Report Designer configuration file.

Metodi pubbliciPublic Methods

CustomReportItemAttributeCustomReportItemAttribute Crea l'oggetto CustomReportItemAttribute.Constructs the CustomReportItemAttribute object.

Microsoft.ReportDesigner.LocalizedNameAttributeMicrosoft.ReportDesigner.LocalizedNameAttribute

Attributo utilizzato per specificare il nome visualizzato da utilizzare per la finestra di progettazione dell'elemento del report personalizzato.This is the attribute used to specify display name to use for the custom report item designer.

Metodi pubbliciPublic Methods

LocalizedNameAttributeLocalizedNameAttribute Crea l'oggetto LocalizedNameAttribute.Constructs the LocalizedNameAttribute object.

Microsoft.ReportDesigner.AdornmentMicrosoft.ReportDesigner.Adornment

La classe Adornment viene usata dal componente della fase di progettazione dell'elemento del report personalizzato per offrire aree esterne al rettangolo principale dell'area di progettazione.The Adornment class is used by the custom report item design-time component to provide areas outside of the main rectangle of the design surface. Tali aree possono gestire eventi dell'interfaccia utente, quali clic del mouse e operazioni di trascinamento della selezione.These areas can handle user interface events, such as mouse clicks and drag-and-drop operations.

Metodi pubbliciPublic Methods

OnShowOnShow Viene chiamato quando Adornment è attivato.Called when the Adornment is activated.
OnHideOnHide Viene chiamato quando Adornment è disattivato.Called when the Adornment is deactivated.
PaintPaint Viene chiamato in risposta all'evento Paint.Called in response to the Paint event.
OnDragEnterOnDragEnter

OnDragOverOnDragOver

OnDragLeaveOnDragLeave

OnDragDropOnDragDrop
Viene chiamato quando un oggetto viene trascinato in Adornment.Called when an object is dragged into the Adornment.

Microsoft.ReportDesigner.AdornerServiceMicrosoft.ReportDesigner.AdornerService

Questa classe viene usata per fornire una raccolta di servizi di visualizzazione usata dall'elemento del report personalizzato per supportare gli oggetti Adornment per il componente della fase di progettazione dell'elemento del report personalizzato.This class is used to provide a collection of display services used by the custom report item to support Adornment objects for the custom report item design-time component.

Proprietà pubblichePublic Properties

AdornerWindowBoundsAdornerWindowBounds Limiti della finestra Adorner.The bounds of the Adorner window.
AdornerWindowRegionAdornerWindowRegion Area della finestra Adorner.The region of the Adorner window.
AdornerWindowGraphicsAdornerWindowGraphics Contesto grafico per la finestra Adorner.A graphics context for the Adorner window.

Metodi pubbliciPublic Methods

ComponentRectInDesignerFrameComponentRectInDesignerFrame Restituisce i limiti del componente convertito nelle coordinate della cornice della finestra di progettazione.Returns the bounds of the component translated into designer frame coordinates.
InvalidateAdornerInvalidateAdorner Invalida la finestra Adorner.Invalidates the Adorner window.
PointToAdornerPointToAdorner Restituisce un punto nelle coordinate dello schermo convertito nelle coordinate della finestra Adorner.Returns a point in screen coordinates translated to Adorner window coordinates.

Microsoft.ReportDesigner.ExpressionEditorMicrosoft.ReportDesigner.ExpressionEditor

Questa classe può essere utilizzata da un controllo della fase di progettazione dell'elemento del report personalizzato per richiamare l'Editor espressioni.This class can be used from your custom report item design-time control to invoke the Expression Editor.

Metodi pubbliciPublic Methods

EditValueEditValue Richiama l'Editor espressioni, inizializzato con il valore dell'oggetto specificato.Invokes the Expression Editor, initialized with the given object value.

Microsoft.ReportDesigner.IFieldsDataObjectMicrosoft.ReportDesigner.IFieldsDataObject

Questa classe è una raccolta di campi di Reporting ServicesReporting Services e viene utilizzata per supportare eventi di trascinamento della selezione nell'ambiente di progettazione.This class is a collection of Reporting ServicesReporting Services fields, and is used to support drag-and-drop events in the design environment. Eredita da IReportItemDataObject.Inherits from IReportItemDataObject.

Proprietà pubblichePublic Properties

DataSetNameDataSetName Nome del set di dati contenente i campi da eliminare.The name of the dataset containing the fields to be dropped.
FieldsFields Raccolta di campi (Microsoft.ReportDesigner.Field) da rilasciare.The collection of fields (Microsoft.ReportDesigner.Field) to be dropped.

Vedere ancheSee Also

Report Definition Language (SSRS) Report Definition Language (SSRS)
Creazione di un componente runtime dell'elemento del report personalizzato Creating a Custom Report Item Run-Time Component
Creazione di un componente dell'elemento del report personalizzato per la fase di progettazioneCreating a Custom Report Item Design-Time Component