BarManager.RestoreLayoutFromXml(String) Method
SECURITY NOTE
Deserializing layout settings from untrusted resources may create security issues. Review the following help topic for additional information: Safe Deserialization.
Restores the bars’ layout from the specified XML file.
Namespace: DevExpress.XtraBars
Assembly: DevExpress.XtraBars.v24.1.dll
NuGet Package: DevExpress.Win.Navigation
Declaration
Parameters
| Name | Type | Description |
|---|---|---|
| xmlFile | String | A string value which specifies the path to the XML file from which bars’ settings are read. If the specified file doesn’t exist, an exception is raised. |
Remarks
Use the RestoreLayoutFromXml method to load the bars’ layout which was written to a file in the XML format using the BarManager.SaveLayoutToXml method.
Note
When restoring a layout during a form load (for instance, in your Form.Load event handler), you may need to call the BarManager.ForceInitialize method prior to the layout restoration. See this method to learn more.
For more information, see Saving and Restoring a Bars Layout Manually.
Example
The following code can be used to read and write a BarManager’s state from/to an XML file.
string xmlFile = "c:\\XtraBars\\States\\MainState.xml";
barManager1.SaveLayoutToXml(xmlFile);
//...
barManager1.RestoreLayoutFromXml(xmlFile);