SaveComponentsEventArgs Class

Provides data for the XtraReport.SaveComponents event.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v20.1.dll

NuGet Packages: DevExpress.Reporting.Core, DevExpress.WindowsDesktop.Reporting.Core

Declaration

C#

public class SaveComponentsEventArgs :
    EventArgs

VB.NET

Public Class SaveComponentsEventArgs
    Inherits EventArgs

Related API Members

SaveComponentsEventArgs is the data class for the following events:

• XtraReport.SaveComponents

Remarks

The XtraReport.SaveComponents event occurs when a report is saved to a REPX file. This event allows you to manually decide which components should be stored into a report definition file, and which aren’t. For example, to prevent a particular component from being saved to a REPX file, simply remove this component from the SaveComponentsEventArgs.Components collection in the XtraReport.SaveComponents event handler.

Note

SaveComponentsEventArgs objects are automatically created, initialized and passed to the XtraReport.SaveComponents event handlers.

Example

This example demonstrates how to exclude a DataSet, along with its TableAdapter, when saving a report definition to an REPX file. To do this, it is necessary to handle the XtraReport.SaveComponents event, and customize its SaveComponentsEventArgs.Components collection.

Tip

Online Example: How to exclude a DataSet and a TableAdapter from a report layout when saving it

C#

using System;
using System.ComponentModel;
using System.Data;
using System.Windows.Forms;
using System.Collections;
using DevExpress.XtraReports.UI;
// ...

private void Form1_Load(object sender, EventArgs e) {
    XtraReport1 report = new XtraReport1();
    report.SaveComponents += new 
        EventHandler<SaveComponentsEventArgs>(report_SaveComponents);
    report.ShowDesignerDialog();
}

void report_SaveComponents(object sender, SaveComponentsEventArgs e) {
    int tableAdapterIdx = GetItemIndex(e.Components, typeof(Component));
    if (tableAdapterIdx >= 0)
        e.Components.RemoveAt(tableAdapterIdx);
    int dsIdx = GetItemIndex(e.Components, typeof(DataSet));
    if (dsIdx >= 0)
        e.Components.RemoveAt(dsIdx);
}

private static int GetItemIndex(IList components, Type targetType) {
    int idx = -1;
    for (int i = 0; i < components.Count; i++) {
        if (components[i].GetType().BaseType == targetType) {
            idx = i;
            break;
        } 
    }

    return idx;
}

VB.NET

Imports System
Imports System.ComponentModel
Imports System.Data
Imports System.Windows.Forms
Imports System.Collections
Imports DevExpress.XtraReports.UI
' ...

Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) _
Handles MyBase.Load
    Dim report As New XtraReport1()
    AddHandler report.SaveComponents, AddressOf report_SaveComponents
    report.ShowDesignerDialog()
End Sub

Private Sub report_SaveComponents(ByVal sender As Object, _
ByVal e As SaveComponentsEventArgs)

    Dim tableAdapterIdx As Integer = GetItemIndex(e.Components, _
    GetType(Component))
    If tableAdapterIdx >= 0 Then
        e.Components.RemoveAt(tableAdapterIdx)
    End If
    Dim dsIdx As Integer = GetItemIndex(e.Components, GetType(DataSet))
    If dsIdx >= 0 Then
        e.Components.RemoveAt(dsIdx)
    End If

End Sub

Private Shared Function GetItemIndex(ByVal components As IList, _
ByVal targetType As Type) As Integer

    Dim idx As Integer = -1
    For i As Integer = 0 To components.Count - 1
        If components(i).GetType().BaseType Is targetType Then
            idx = i
            Exit For
        End If
    Next i

    Return idx
End Function

Inheritance

Object

EventArgs

SaveComponentsEventArgs