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

Elementi del report personalizzati di usare le classi dal Microsoft.ReportDesigner dello spazio dei nomi.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 su come usare queste classi, vedere SQL Server Reporting Services Product Samples.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.
AltezzaHeight Altezza del controllo dell'elemento del report personalizzato.The height of the custom report item control.
LarghezzaWidth 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.
Area di controlloAdornment Finestra dell'area di controllo utilizzata per la modifica interattiva del controllo.An adornment window used for interactive editing of the control.
SitoSite Il ISite del componente.The ISite of the component.
Insieme 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.
InvalidareInvalidate 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 Chiamato in risposta al Paint evento.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 del < nome> attributo del ReportItem elemento 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

Il dell'area di controllo classe viene utilizzata dal componente in fase di progettazione dell'elemento di report personalizzato per fornire 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 Chiamato quando il dell'area di controllo è attivato.Called when the Adornment is activated.
OnHideOnHide Chiamato quando il dell'area di controllo viene disattivato.Called when the Adornment is deactivated.
DisegnoPaint Chiamato in risposta al Paint evento.Called in response to the Paint event.
OnDragEnterOnDragEnter

OnDragOverOnDragOver

OnDragLeaveOnDragLeave

OnDragDropOnDragDrop
Chiamata eseguita quando un oggetto viene trascinato il dell'area di controllo.Called when an object is dragged into the Adornment.

Microsoft.ReportDesigner.AdornerServiceMicrosoft.ReportDesigner.AdornerService

Questa classe viene utilizzata per fornire una raccolta di servizi visualizzati utilizzati dall'elemento del report personalizzato per supportare dell'area di controllo oggetti per il componente in fase di progettazione di 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.
CampiFields La raccolta di campi (Microsoft.ReportDesigner.Field) da eliminare.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 di Run-Time di elemento di Report personalizzato Creating a Custom Report Item Run-Time Component
Creazione di un componente in fase di progettazione dell'elemento del Report personalizzatoCreating a Custom Report Item Design-Time Component