Merge pull request #3541 from syncfusion-content/Export_DetailsView

976266-Prepare UG documentation for MasterDetailsView DataGrid Exporting in .net MAUI.

Author: FarjanaParveen

MAUI/DataGrid/Images/export-to-excel/maui-datagrid-customize-detailsview-excel.png

@@ -26,7 +26,7 @@ To export the SfDataGrid to an Excel file, the following NuGet package should be
 </table>
 
 ## Save Service class in portable project.
-Add the new class file with name as SaveService to the Project and add below code in it. This is the helper class used to save and view the excell file in Windows, Android, IOS and MAC devices.
+Add the new class file with name as SaveService to the Project and add below code in it. This is the helper class used to save and view the excel file in Windows, Android, iOS and MAC devices.
 
 {% tabs %}
 {% highlight c# %}
@@ -228,9 +228,9 @@ Add the following code to the AndroidManifest.xml file located under Properties
 {% endhighlight %}
 {% endtabs %}
 
-### Save and View the Excel document in IOS
+### Save and View the Excel document in iOS
 
-Add the new class file with name SaveIOS file under Platforms -> IOS directory to save and view the Excell document in the IOS device and use the below code in it.
+Add the new class file with name SaveIOS file under Platforms -> iOS directory to save and view the Excel document in the iOS device and use the below code in it.
 
 {% tabs %}
 {% highlight c# %}
@@ -356,7 +356,7 @@ namespace GettingStarted
 
 ### Save and View the Excel document in MacCatalyst
 
-Add the new class file with name SaveMAC file under Platforms -> MacCatylyst directory to save and view the Excel document in the MAC Device and use the below code in it.
+Add the new class file with name SaveMAC file under Platforms -> MacCatalyst directory to save and view the Excel document in the MAC Device and use the below code in it.
 
 {% tabs %}
 {% highlight c# %}
@@ -1051,4 +1051,81 @@ private void ExcelExport_RowExporting(object sender, DataGridRowExcelExportingEv
     }
 }
 {% endhighlight %}
-{% endtabs %}
+{% endtabs %}
+
+### Exporting DetailsView
+
+By default, [DetailsViewDataGrid](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.DataGrid.DetailsViewDataGrid.html) will not be exported to Excel. You can export `DetailsViewDataGrid` by setting `CanExportDetailsView` property as true. You can customize its exporting operation by using `DataGridChildExcelExportingEventArgs`.
+
+## Excluding DetailsViewDataGrid while exporting
+
+You can exclude particular DetailsViewDataGrid while exporting by using the `DataGridChildExcelExportingEventArgs.Cancel` property.
+
+```csharp
+private void Button_Clicked_1(object sender, EventArgs e)
+{
+    DataGridExcelExportingController excelExport = new DataGridExcelExportingController();
+    DataGridExcelExportingOption option = new DataGridExcelExportingOption();
+    excelExport.DataGridChildExcelExporting += ExcelExport_DataGridChildExcelExporting;
+    option.CanExportDetailsView= true;
+    var excelEngine = excelExport.ExportToExcel(this.dataGrid, option);
+    var workbook = excelEngine.Excel.Workbooks[0];
+    MemoryStream stream = new MemoryStream();
+    workbook.SaveAs(stream);
+    workbook.Close();
+    excelEngine.Dispose();
+    string OutputFilename = "ExportFeature.xlsx";
+    SaveService saveService = new();
+    saveService.SaveAndView(OutputFilename, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", stream);
+}
+
+private void ExcelExport_DataGridChildExcelExporting(object? sender, DataGridChildExcelExportingEventArgs e)
+{
+    var recordEntry = e.NodeEntry as RecordEntry;
+
+    if ((recordEntry?.Data as Orders)?.OrderID == 1002)
+        e.Cancel = true;
+}
+```
+<img alt="Excluding specific DetailsView while exporting to Excel in DataGrid " src="Images\export-to-excel\maui-datagrid-detailsviewexporting.png" Width="404"/>
+
+Here, `DetailsViewDataGrid` is not exported for the parent record having OrderID as 1002.
+
+## Customizing DetailsViewDataGrid cells
+
+Similar to the parent DataGrid, you can also customize the cells of the DetailsViewDataGrid using the [DataGridCellExcelExportingEventArgs](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.DataGrid.Exporting.DataGridCellExcelExportingEventArgs.html). By utilizing the `DataGridCellExcelExportingEventArgs.DetailsViewDefinition` property, you can identify the specific DetailsViewDataGrid and make your customizations.
+
+```csharp
+    private void Button_Clicked_1(object sender, EventArgs e)
+    {
+        DataGridExcelExportingController excelExport = new DataGridExcelExportingController();
+        DataGridExcelExportingOption option = new DataGridExcelExportingOption();
+        excelExport.CellExporting += ExcelExport_CellExporting;
+        option.CanExportDetailsView= true;
+        var excelEngine = excelExport.ExportToExcel(this.dataGrid, option);
+        var workbook = excelEngine.Excel.Workbooks[0];
+        MemoryStream stream = new MemoryStream();
+        workbook.SaveAs(stream);
+        workbook.Close();
+        excelEngine.Dispose();
+        string OutputFilename = "ExportFeature.xlsx";
+        SaveService saveService = new();
+        saveService.SaveAndView(OutputFilename, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", stream);
+    }
+
+    private void ExcelExport_CellExporting(object? sender, DataGridCellExcelExportingEventArgs e)
+    {
+        if (e.DetailsViewDefinition == null && e.DetailsViewDefinition?.RelationalColumn != "OrdersList")
+        {
+            return;
+        }
+
+        if (e.ColumnName == "OrderID")
+        {
+            e.Range.CellStyle.Font.Size = 12;
+            e.Range.CellStyle.Font.Color = ExcelKnownColors.Blue;
+            e.Range.CellStyle.Font.FontName = "Segoe UI";
+        }
+    }
+```
+<img alt="Customizing DetailsViewDataGrid while exporting to Excel in DataGrid" src="Images/export-to-excel/maui-datagrid-customize-detailsview-excel.png" Width="404"/>

MAUI/DataGrid/Images/export-to-excel/maui-datagrid-detailsviewexporting.png

@@ -1144,4 +1144,112 @@ private void PdfExport_CellExporting(object sender, DataGridCellPdfExportingEven
 {% endhighlight %}
 {% endtabs %}
 
-<img alt="Export DataGrid to PDF format with customized cell style" src="Images\export-to-pdf\maui-datagrid-style-based-on-column-name.png" width="689"/>
+<img alt="Export DataGrid to PDF format with customized cell style" src="Images\export-to-pdf\maui-datagrid-style-based-on-column-name.png" width="689"/>
+
+### Exporting DetailsView
+
+By default, [DetailsViewDataGrid](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.DataGrid.DetailsViewDataGrid.html) will not be exported to PDF. You can export `DetailsViewDataGrid` by setting `CanExportDetailsView` property as true.
+
+```csharp
+MemoryStream stream = new MemoryStream();
+DataGridPdfExportingController pdfExport = new DataGridPdfExportingController();
+DataGridPdfExportingOption option = new DataGridPdfExportingOption();
+option.CanExportDetailsView = true;
+var pdfDoc = pdfExport.ExportToPdf(this.dataGrid, option);
+pdfDoc.Save(stream);
+pdfDoc.Close(true);
+SaveService saveService = new();
+saveService.SaveAndView("ExportFeature.pdf", "application/pdf", stream);
+```
+<img src="Images/export-to-pdf/maui-datagrid-exportdetailsview.png" alt="Maui DataGrid displays Nested dataGrid exported to PDF" width="404"/>
+
+By default, only expanded DetailsViewDataGrids will be exported to the PDF document. If you want to export all the DetailsViewDataGrids, you need to set `CanExportAllDetails` to true.
+
+```csharp
+MemoryStream stream = new MemoryStream();
+DataGridPdfExportingController pdfExport = new DataGridPdfExportingController();
+DataGridPdfExportingOption option = new DataGridPdfExportingOption();
+option.CanExportDetailsView = true;
+option.CanExportAllDetails = true;
+var pdfDoc = pdfExport.ExportToPdf(this.dataGrid, option);
+pdfDoc.Save(stream);
+pdfDoc.Close(true);
+SaveService saveService = new();
+saveService.SaveAndView("ExportFeature.pdf", "application/pdf", stream);
+```
+<img src="Images\export-to-pdf\maui-datagrid-exportalldetails.png" alt="Nested dataGrid exported to PDF" width="404"/>
+
+Here, first record only expanded in SfDataGrid. But all the DetailsViewDataGrid’s are shown in exported PDF document.
+
+You can customize its exporting operation by using `DataGridChildPdfExportingEventArgs`.
+
+N> While exporting DetailsViewDataGrid, `CanFitAllColumnInOnePage` is set to true internally as horizontal pagination is not supported for DetailsViewDataGrid.
+
+## Excluding DetailsViewDataGrid while exporting
+
+You can exclude particular DetailsViewDataGrid while exporting, by using the `DataGridChildPdfExportingEventArgs.Cancel`.
+
+```csharp
+private void Button_Clicked(object sender, EventArgs e)
+{
+    MemoryStream stream = new MemoryStream();
+    DataGridPdfExportingController pdfExport = new DataGridPdfExportingController();
+    DataGridPdfExportingOption option = new DataGridPdfExportingOption();
+    pdfExport.DataGridChildPdfExporting += PdfExport_DataGridChildPdfExporting;
+    option.CanExportDetailsView = true;
+    var pdfDoc = pdfExport.ExportToPdf(this.dataGrid, option);
+    pdfDoc.Save(stream);
+    pdfDoc.Close(true);
+    SaveService saveService = new();
+    saveService.SaveAndView("ExportFeature.pdf", "application/pdf", stream);
+}
+
+private void PdfExport_DataGridChildPdfExporting(object? sender, DataGridChildPdfExportingEventArgs e)
+{
+    var recordEntry = e.NodeEntry as RecordEntry;
+
+    if ((recordEntry?.Data as Orders)?.OrderID == 1002)
+        e.Cancel = true;
+}
+```
+<img alt="Excluding specific DetailsView while exporting to PDF in DataGrid " src="Images/export-to-pdf/maui-datagrid-excluderows.png" Width="404"/>
+
+Here, `DetailsViewDataGrid` is not exported for the parent record having OrderID as 1002.
+
+## Customizing DetailsViewDataGrid cells
+
+Similar to the parent DataGrid, you can also customize the cells of the DetailsViewDataGrid by using the DataGridCellPdfExportingEventArgs. By utilizing the `DataGridCellPdfExportingEventArgs.DetailsViewDefinition` property, you can identify the specific DetailsViewDataGrid and customize it accordingly.
+
+```csharp
+    private void Button_Clicked_1(object sender, EventArgs e)
+    {
+        MemoryStream stream = new MemoryStream();
+        DataGridPdfExportingController pdfExport = new DataGridPdfExportingController();
+        DataGridPdfExportingOption option = new DataGridPdfExportingOption();
+        pdfExport.DataGridChildPdfExporting += PdfExport_DataGridChildPdfExporting;
+        pdfExport.CellExporting += PdfExport_CellExporting;
+        option.CanExportDetailsView = true;
+        var pdfDoc = pdfExport.ExportToPdf(this.dataGrid, option);
+        pdfDoc.Save(stream);
+        pdfDoc.Close(true);
+        SaveService saveService = new();
+        saveService.SaveAndView("ExportFeature.pdf", "application/pdf", stream);
+    }
+
+    private void PdfExport_CellExporting(object? sender, DataGridCellPdfExportingEventArgs e)
+    {
+        if (e.DetailsViewDefinition == null && e.DetailsViewDefinition?.RelationalColumn != "OrdersList")
+        {
+            return;
+        }
+
+        if (e.ColumnName == "OrderID")
+        {
+            var cellStyle = new PdfGridCellStyle();
+            cellStyle.BackgroundBrush = PdfBrushes.Wheat;
+            cellStyle.Borders.All = new PdfPen(PdfBrushes.DarkGray, 0.2f);
+            e.PdfGridCell.Style = cellStyle;
+        }
+    }
+```
+<img alt="Customizing DetailsViewDataGrid while exporting to PDF in DataGrid" src="Images/export-to-pdf/maui-datagrid-customize-detailsview.png" Width="404"/>