Librerie di classi degli elementi del report personalizzate

Gli elementi del report personalizzati usano 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 un esempio di codice sull'uso di queste classi, vedere SQL Server Reporting Services Product Samples (Esempi del prodotto 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

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

Proprietà	Descrizione
Nome	Nome dell'elemento del report personalizzato.
Type	Tipo di elemento del report personalizzato.
CustomData	Oggetto 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.
Altezza	Altezza del controllo dell'elemento del report personalizzato.
Larghezza	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 usare in cui il controllo runtime dell'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.
Sito	Interfaccia ISite del componente.
DesignerVerbCollection	Matrice di verbi personalizzati per il menu di scelta rapida del controllo.

Metodi pubblici

metodo	Descrizione
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

Microsoft.ReportDesigner.CustomReportItemAttribute è l'attributo usato per identificare il tipo dell'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

metodo	Descrizione
CustomReportItemAttribute	Crea l'oggetto CustomReportItemAttribute.

Microsoft.ReportDesigner.LocalizedNameAttribute

Microsoft.ReportDesigner.LocalizedNameAttribute è l'attributo utilizzato per specificare il nome visualizzato da utilizzare per la finestra di progettazione dell'elemento del report personalizzato.

Metodi pubblici

metodo	Descrizione
LocalizedNameAttribute	Crea l'oggetto LocalizedNameAttribute.

Microsoft.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. Tali aree possono gestire eventi dell'interfaccia utente, quali clic del mouse e operazioni di trascinamento della selezione.

Metodi pubblici

metodo	Descrizione
OnShow	Viene chiamato quando Adornment è attivato.
OnHide	Viene chiamato quando Adornment è disattivato.
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 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.

Proprietà pubbliche

Proprietà	Descrizione
AdornerWindowBounds	Limiti della finestra Adorner.
AdornerWindowRegion	Area della finestra Adorner.
AdornerWindowGraphics	Contesto grafico per la finestra Adorner.

Metodi pubblici

metodo	Descrizione
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

metodo	Descrizione
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 usata per supportare eventi di trascinamento della selezione nell'ambiente di progettazione. Eredita da IReportItemDataObject.

Proprietà pubbliche

Proprietà	Descrizione
DataSetName	Nome del set di dati contenente i campi da eliminare.
Campi	Raccolta di campi (Microsoft.ReportDesigner.Field) da rilasciare.

Contenuto correlato

Report Definition Language (SSRS)
Creazione di un componente di runtime dell'elemento del report personalizzato
Creazione di un componente personalizzato della fase di progettazione dell'elemento del report