xtrareports-devexpress-dot-xtrareports-dot-extensions-dot-reportdesignextension-dot-associatereportwithextension-x28-devexpress-dot-xtrareports-dot-ui-dot-xtrareport-system-dot-string-x29.md
Associates the report with the custom design extension, to employ parameters of custom types.
Namespace : DevExpress.XtraReports.Extensions
Assembly : DevExpress.XtraReports.v25.2.Extensions.dll
NuGet Package : DevExpress.Win.Reporting
public static void AssociateReportWithExtension(
XtraReport report,
string contextName
)
Public Shared Sub AssociateReportWithExtension(
report As XtraReport,
contextName As String
)
| Name | Type | Description |
|---|---|---|
| report | XtraReport |
An XtraReport class descendant.
| | contextName | String |
A String value, identifying the context.
|
To provide parameters of custom types to your report, you should create a custom report design extension inherited from the ReportDesignExtension class.
Then, register the extension (using the ReportDesignExtension.RegisterExtension method) and associate the report with the custom extension (using the AssociateReportWithExtension method).
To learn more, see Creating Custom Report Parameters.
The following code snippets (auto-collected from DevExpress Examples) contain references to the AssociateReportWithExtension(XtraReport, String) method.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.
reporting-winforms-custom-xml-serialization/CS/WindowsApplication54/Form1.cs#L36
void OnDesignPanelLoaded(object sender, DevExpress.XtraReports.UserDesigner.DesignerLoadedEventArgs e) {
ReportDesignExtension.AssociateReportWithExtension((XtraReport)e.DesignerHost.RootComponent, ExtensionName);
}
reporting-winforms-parameter-custom-type-serialization/CS/Form1.cs#L29
ReportDesignExtension.AssociateReportWithExtension(report, TeamParameterName);
reporting-winforms-custom-xml-serialization/VB/WindowsApplication54/Form1.vb#L39
Private Sub OnDesignPanelLoaded(ByVal sender As Object, ByVal e As DevExpress.XtraReports.UserDesigner.DesignerLoadedEventArgs)
ReportDesignExtension.AssociateReportWithExtension(CType(e.DesignerHost.RootComponent, XtraReport), ExtensionName)
End Sub
reporting-winforms-parameter-custom-type-serialization/VB/Form1.vb#L31
ReportDesignExtension.AssociateReportWithExtension(report, TeamParameterName)
report.Parameters.Add(New DevExpress.XtraReports.Parameters.Parameter() With {
See Also