Back to Devexpress

RibbonControl.InvalidSaveRestoreLayoutException Event

windowsforms-devexpress-dot-xtrabars-dot-ribbon-dot-ribboncontrol-b2b885b5.md

latest3.0 KB
Original Source

RibbonControl.InvalidSaveRestoreLayoutException Event

SECURITY-RELATED CONSIDERATIONS

Deserializing layout settings from untrusted resources may create security issues. Review the following help topic for additional information: Safe Deserialization.

Fires whenever saving or loading a RibbonControl‘s layout fails.

Namespace : DevExpress.XtraBars.Ribbon

Assembly : DevExpress.XtraBars.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

Declaration

csharp
[DXCategory("Events")]
public event EventHandler<InvalidLayoutExceptionEventArgs> InvalidSaveRestoreLayoutException
vb
<DXCategory("Events")>
Public Event InvalidSaveRestoreLayoutException As EventHandler(Of InvalidLayoutExceptionEventArgs)

Event Data

The InvalidSaveRestoreLayoutException event's data class is DevExpress.XtraBars.Ribbon.InvalidLayoutExceptionEventArgs.

Remarks

An end-user can customize a RibbonControl at runtime if the RibbonControl.AllowCustomization property is set to true. Customized layouts can also be saved to an XML file or loaded from it (use the RibbonControl.SaveLayoutToXml and RibbonControl.RestoreLayoutFromXml methods to do it in code). If saving or restoring a layout fails for any reason, the InvalidSaveRestoreLayoutException event is raised. This also works for unsuccessful layout auto-save attempts (see the RibbonControl.AutoSaveLayoutToXml property description).

See Also

AllowCustomization

SaveLayoutToXml(String)

RestoreLayoutFromXml(String)

AutoSaveLayoutToXml

AutoSaveLayoutToXmlPath

RibbonControl Class

RibbonControl Members

DevExpress.XtraBars.Ribbon Namespace