XtraReport.FromStream(Stream, Boolean) Method

Loads the report definition data from the specified stream and creates a report object from it. The created report’s class is also specified in the REPX data format.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v19.2.dll

NuGet Package: DevExpress.Reporting.Core

Declaration

C#

public static XtraReport FromStream(
    Stream stream,
    bool loadState = true
)

VB.NET

Public Shared Function FromStream(
    stream As Stream,
    loadState As Boolean = True
) As XtraReport

Parameters

Name	Type	Description
stream	Stream	The Stream object containing the REPX or XML data to load.

Optional Parameters

Name	Type	Default	Description
loadState	Boolean	True	true to load the report’s state which is also saved in the REPX or XML data; otherwise, false.

Returns

Type	Description
XtraReport	An XtraReport class or its descendant of the type specified in the REPX or XML data.

Remarks

Important

Deserialization of reports obtained from untrusted parties can trigger execution of malicious code that can either be directly embedded into the report definition, or contained in an external assembly referenced by the report.

To avoid this, we recommend that you use XML serialization instead of CodeDOM and prevent any untrusted third-party libraries from becoming available on the server.

When a reporting application is deployed under the Medium Trust permission level, XML serialization is the only option to save reports (CodeDOM serialization is not supported in such environment).

Use this method to create a report instance from the report definition data stored in the specified stream. Note, that to be able to create the report, this method should find the class type of the creating report (the report class’s type name is stored in the REPX data header). This type is searched for in the following assemblies:

1. In the assembly (represented by the .EXE or .DLL file) which produced the report definition data. Its path is also mentioned in the report definition’s header;
2. In the current assembly where the FromStream method is called from;
3. In the assemblies referenced by the current assembly;
4. In the loaded assemblies.

If this class type is not found, an instance of the XtraReport class is created.

The saved state can be applied to the created report instance if the loadState parameter is set to true.

Example

This example demonstrates how to save a report definition to a stream (assigned to a corresponding ASP.NET Session) as a REPX file and restored back by using the XtraReport.SaveLayout and XtraReport.FromStream methods.

C#

using System.IO;
using DevExpress.XtraReports.UI;
// ...

private void StoreReport(XtraReport report) {
   // Create a stream.
   MemoryStream stream = new MemoryStream();

   // Save a report to the stream.
   report.SaveLayout(stream);

   // Save the stream to a session.
   Session["report_stream"] = stream;
}

private XtraReport RestoreReport() {
   // Restore the stream from the session.
   MemoryStream stream = (MemoryStream)Session["report_stream"];

   // Create a report from the stream.
   return XtraReport.FromStream(stream, true);
}

VB.NET

Imports System.IO
Imports DevExpress.XtraReports.UI
' ...

Private Sub StoreReport(report As XtraReport)
   ' Create a stream.
   Dim stream As New MemoryStream()

   ' Save a report to the stream.
   report.SaveLayout(stream)

   ' Save the stream to a session.
   Session("report_stream") = stream
End Sub

Private Function RestoreReport() As XtraReport
   ' Restore the stream from the session.
   Dim stream As MemoryStream = CType(Session("report_stream"), MemoryStream)

   ' Create a report from the stream.
   Return XtraReport.FromStream(stream, True)
End Function

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the FromStream(Stream, Boolean) 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.

C#

Reporting_how-to-store-reports-in-a-database-e698/CS/Form1.cs#L57

    sw.Flush();
    newReport = XtraReport.FromStream(sw.BaseStream, true);
}

reporting-wpf-report-storage/CS/WpfApplication38/Storages/DataSetFileStorage.cs#L186

{
    return XtraReport.FromStream(ms, true);
}

reporting-winforms-custom-report-storage/CS/Form1.cs#L44

using (MemoryStream stream = new MemoryStream(Program.ReportStorage.GetData(url))) {
    return XtraReport.FromStream(stream, true);
}

reporting-web-mvc-viewer-clustering/CS/DevExpressWebFarmsWebGardenReporting/ReportStorageWebExtension1.cs#L28

using(var fileStream = File.OpenRead(Path.Combine(workingDirectory, url))) {
    var report = XtraReport.FromStream(fileStream, true);
    return SerializeReport(report);

VB.NET

Reporting_how-to-store-reports-in-a-database-e698/VB/Form1.vb#L59

    sw.Flush()
    newReport = XtraReport.FromStream(sw.BaseStream, True)
End Using

reporting-wpf-report-storage/VB/WpfApplication38/Storages/DataSetFileStorage.vb#L163

Using ms As New MemoryStream(row.Buffer)
    Return XtraReport.FromStream(ms, True)
End Using

reporting-winforms-custom-report-storage/VB/Form1.vb#L50

Using stream As New MemoryStream(Program.ReportStorage.GetData(url))
    Return XtraReport.FromStream(stream, True)
End Using

reporting-web-mvc-viewer-clustering/VB/DevExpressWebFarmsWebGardenReporting/ReportStorageWebExtension1.vb#L30

Using fileStream = File.OpenRead(Path.Combine(workingDirectory, url))
    Dim report = XtraReport.FromStream(fileStream, True)
    Return SerializeReport(report)