Added new kb article refresh-telerik-native-blazor-report-viewer-new-parameters

knowledge-base/refresh-telerik-native-blazor-report-viewer-new-parameters.md

@@ -0,0 +1,78 @@
+---
+title: Change the Parameters Programmatically in Native Blazor Report Viewer
+description: "Learn how to change the Native Blazor Report Viewer parameter values programmatically by creating a new ReportSourceOptions object."
+type: how-to
+page_title: Pass the Parameters Programmatically in Native Blazor Report Viewer
+slug: change-telerik-native-blazor-report-viewer-parameters-values-programmatically
+tags: telerik reporting, reportviewer, parameters, native blazor, onparameterssetasync, reportsourceoptions
+res_type: kb
+ticketid: 1690218
+---
+
+## Environment
+
+<table>
+    <tbody>
+        <tr>
+            <td>Product</td>
+            <td>Progress® Telerik® Reporting</td>
+        </tr>
+        <tr>
+            <td>Viwer</td>
+            <td>Native Blazor Report Viewer</td>
+        </tr>
+    </tbody>
+</table>
+
+## Description
+
+I cannot get the [Native Blazor Report Viewer]({%slug telerikreporting/embedding-reports/display-reports-in-applications/web-application/native-blazor-report-viewer/overview%}) to refresh the report based on new parameter values after displaying the report with default parameters. When I update parameters programmatically. For example, using a dropdown—the report does not refresh, even though the [OnParametersSetAsync](https://learn.microsoft.com/en-us/dotnet/api/microsoft.aspnetcore.components.componentbase.onparameterssetasync) method executes with the new parameter values.
+
+However, if I use the parameter input area in the Report Viewer interface, the report refreshes properly with the updated values. I need a way to programmatically pass new parameters and redisplay the report with these values.
+
+This knowledge-base article also answers the following questions:
+
+* How do I refresh the Native Blazor Report Viewer with new parameters?
+* Why doesn't the Native Blazor Report Viewer reflect parameter changes programmatically?
+* How can I pass changed parameters to Telerik Native Blazor Report Viewer?
+
+## Solution
+
+To refresh the [Native Blazor Report Viewer]({%slug telerikreporting/embedding-reports/display-reports-in-applications/web-application/native-blazor-report-viewer/overview%})  programmatically with new parameter values, ensure that you create a new `ReportSourceOptions` object when updating the `ReportSource` property. Modifying the existing object will not trigger the refresh. Below is an example demonstrating this approach.
+
+### Example
+
+>note While the example below is made using the [OnParametersSetAsync](https://learn.microsoft.com/en-us/dotnet/api/microsoft.aspnetcore.components.componentbase.onparameterssetasync) lifecycle event, it is not required to use this Blazor event, or any event at all, the `ReportSource` can be edited outside the Blazor events as well as long as a new `ReportSourceOptions` object is provided. 
+
+Use the following code snippet in the [OnParametersSetAsync](https://learn.microsoft.com/en-us/dotnet/api/microsoft.aspnetcore.components.componentbase.onparameterssetasync) lifecycle event:
+
+````C#
+protected override async Task OnParametersSetAsync()
+{
+    // Create a new ReportSourceOptions object with the updated parameters
+    var rso = new ReportSourceOptions()
+    {
+        Report = "Report1.trdp", 
+        Parameters = new Dictionary<string, object>
+        {
+            {"Category", SelectedCategory} // Pass the updated parameter value
+        }     
+    };
+
+    // Assign the new object to the ReportSource property
+    ReportSource = rso;
+
+    await base.OnParametersSetAsync();
+}
+````
+
+### Key Points
+
+1. Always create a **new** `ReportSourceOptions` object when updating the `ReportSource` property.
+1. Assign the updated parameter values to the `Parameters` dictionary within the new object.
+1. Ensure the `ReportSource` property references the new object to trigger the refresh.
+
+## See Also
+
+* [Native Blazor Report Viewer Documentation]({%slug telerikreporting/embedding-reports/display-reports-in-applications/web-application/native-blazor-report-viewer/overview%})
+* [Embedding Reports in Blazor Applications]({%slug telerikreporting/using-reports-in-applications/display-reports-in-applications/web-application/blazor-report-viewer/how-to-use-blazor-report-viewer%})