Librerie di classi dell'elemento del report personalizzato
Gli elementi del report personalizzati utilizzano le classi dello spazio dei nomi Microsoft.ReportDesigner. 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. Per ulteriori informazioni su un esempio di codice relativo all'utilizzo di queste classi, vedere la pagina relativa agli esempi del prodotto per SQL Server Reporting Services.
Classi di infrastruttura dell'elemento del report personalizzato
Le classi riportate di seguito vengono utilizzate per implementare un elemento del report personalizzato.
[!NOTA]
Nelle tabelle seguenti non vengono forniti elenchi completi, ma solo le proprietà e i metodi utilizzati più di frequente per ciascuna classe.
Microsoft.ReportDesigner.CustomReportItemDesigner
È la classe principale dell'elemento del report personalizzato. La classe principale dell'implementazione dell'elemento del report personalizzato deve ereditare da questa classe.
Proprietà pubbliche
Name |
Nome dell'elemento del report personalizzato. |
Type |
Tipo di elemento del report personalizzato. |
CustomData |
Classe Microsoft.ReportingServices.ReportRendering.CustomReportItem.CustomData che incapsula le proprietà dei dati dell'elemento del report personalizzato specificate in fase di progettazione. |
CustomProperties |
Raccolta di proprietà personalizzate per l'elemento del report personalizzato. |
Height |
Altezza del controllo dell'elemento del report personalizzato. |
Width |
Larghezza del controllo dell'elemento del report personalizzato. |
Report |
Contenitore per le proprietà a livello di report, ad esempio l'elenco dei set di dati nel report. |
AltReportItem |
Oggetto elemento del report alternativo, da utilizzare se il controllo di runtime di un elemento del report personalizzato non è supportato. |
Style |
Proprietà di stile per l'elemento del report personalizzato. |
Adornment |
Finestra dell'area di controllo utilizzata per la modifica interattiva del controllo. |
Site |
ISite dell'oggetto component. |
DesignerVerbCollection |
Matrice di verbi personalizzati per il menu di scelta rapida del controllo. |
Metodi pubblici
BeginEdit |
Attiva la modifica interattiva per il controllo. |
DoDefaultAction |
Viene chiamato quando si fa doppio clic o si preme Invio sul controllo. |
EndEdit |
Disattiva la modifica interattiva per il controllo. |
GetService |
Restituisce un oggetto che rappresenta un servizio. |
InitializeNewComponent |
Viene chiamato quando si crea un nuovo elemento del report personalizzato. |
Invalidate |
Ridisegna l'intera superficie del controllo. |
OnDragEnter OnDragDrop |
Viene chiamato quando si trascina un oggetto sul controllo. |
OnPaint |
Viene chiamato in risposta all'evento Paint. |
Microsoft.ReportDesigner.CustomReportItemAttribute
Attributo utilizzato per identificare il tipo di elemento del report personalizzato. Il nome deve corrispondere al valore dell'attributo <Name> dell'elemento ReportItem nel file di configurazione di Progettazione report.
Metodi pubblici
CustomReportItemAttribute |
Crea l'oggetto CustomReportItemAttribute. |
Microsoft.ReportDesigner.LocalizedNameAttribute
Attributo utilizzato per specificare il nome visualizzato da utilizzare per la finestra di progettazione dell'elemento del report personalizzato.
Metodi pubblici
LocalizedNameAttribute |
Crea l'oggetto LocalizedNameAttribute. |
Microsoft.ReportDesigner.Adornment
La classe Adornment viene utilizzata dal componente dell'elemento del report personalizzato per la fase di progettazione per fornire aree esterne al rettangolo principale dell'area di progettazione. Tali aree possono gestire eventi dell'interfaccia utente, quali clic del mouse e operazioni di trascinamento della selezione.
Metodi pubblici
OnShow |
Viene chiamato quando viene attivato Adornment. |
OnHide |
Viene chiamato quando viene disattivato Adornment. |
Paint |
Viene chiamato in risposta all'evento Paint. |
OnDragEnter OnDragOver OnDragLeave OnDragDrop |
Viene chiamato quando un oggetto viene trascinato in Adornment. |
Microsoft.ReportDesigner.AdornerService
Questa classe viene utilizzata per fornire una raccolta di servizi visualizzati utilizzati dall'elemento del report personalizzato per supportare gli oggetti Adornment per il componente della fase di progettazione dell'elemento del report personalizzato.
Proprietà pubbliche
AdornerWindowBounds |
Limiti della finestra Adorner. |
AdornerWindowRegion |
Area della finestra Adorner. |
AdornerWindowGraphics |
Contesto grafico per la finestra Adorner. |
Metodi pubblici
ComponentRectInDesignerFrame |
Restituisce i limiti del componente convertito nelle coordinate della cornice della finestra di progettazione. |
InvalidateAdorner |
Invalida la finestra Adorner. |
PointToAdorner |
Restituisce un punto nelle coordinate dello schermo convertito nelle coordinate della finestra Adorner. |
Microsoft.ReportDesigner.ExpressionEditor
Questa classe può essere utilizzata da un controllo della fase di progettazione dell'elemento del report personalizzato per richiamare l'Editor espressioni.
Metodi pubblici
EditValue |
Richiama l'Editor espressioni, inizializzato con il valore dell'oggetto specificato. |
Microsoft.ReportDesigner.IFieldsDataObject
Questa classe è una raccolta di campi di Reporting Services e viene utilizzata per supportare eventi di trascinamento della selezione nell'ambiente di progettazione. Eredita da IReportItemDataObject.
Proprietà pubbliche
DataSetName |
Nome del set di dati contenente i campi da eliminare. |
Fields |
Raccolta di campi (Microsoft.ReportDesigner.Field) da eliminare. |