Code:
/ 4.0 / 4.0 / untmp / DEVDIV_TFS / Dev10 / Releases / RTMRel / ndp / cdf / src / NetFx40 / Tools / System.Activities.Presentation / System / Activities / Presentation / Base / Interaction / Model / ModelEditingScope.cs / 1305376 / ModelEditingScope.cs
//------------------------------------------------------------------------------ //// Copyright (c) Microsoft Corporation. All rights reserved. // //----------------------------------------------------------------------------- namespace System.Activities.Presentation.Model { using System; using System.Collections.Generic; using System.Globalization; using System.Activities.Presentation; using System.Diagnostics.CodeAnalysis; using System.Runtime; ////// A ModelEditingScope represents a group of changes to the /// editing store. Change groups are transactional: /// changes made under an editing scope can be committed /// or aborted as a unit. /// /// When an editing scope is committed, the editing store /// takes all changes that occurred within it and applies /// them to the model. If the editing scope�s Revert method /// is called, or the editing scope is disposed before Complete /// is called, the editing scope will instead reverse the /// changes made to the underlying objects, reapplying state /// from the editing store. This provides a solid basis for /// an undo mechanism. /// public abstract class ModelEditingScope : IDisposable { private string _description; private bool _completed; private bool _reverted; ////// Creates a new ModelEditingScope object. /// protected ModelEditingScope() { } ////// Describes the group. You may change this property /// anytime before the group is committed. /// public string Description { get { return (_description == null ? string.Empty : _description); } set { _description = value; } } ////// Completes the editing scope. If the editing scope has /// already been reverted or completed, this will throw an /// InvalidOperationException. Calling Complete calls the /// protected OnComplete method. /// ///If ModelEditingScope /// has already been complted or reverted. [SuppressMessage("Microsoft.Usage", "CA1816:CallGCSuppressFinalizeCorrectly", Justification = "By design.")] [SuppressMessage("Microsoft.Design", "CA1031:DoNotCatchGeneralExceptionTypes", Justification = "By design.")] public void Complete() { if (_reverted) throw FxTrace.Exception.AsError(new InvalidOperationException(System.Activities.Presentation.Internal.Properties.Resources.Error_EditingScopeReverted)); if (_completed) throw FxTrace.Exception.AsError(new InvalidOperationException(System.Activities.Presentation.Internal.Properties.Resources.Error_EdtingScopeCompleted)); if (CanComplete()) { bool successful = false; _completed = true; // prevent recursive commits try { OnComplete(); successful = true; } catch (Exception e) { _completed = false; Revert(); if (Fx.IsFatal(e)) { throw; } if (!OnException(e)) { throw; } } finally { if (successful) { GC.SuppressFinalize(this); } else { _completed = false; } } } else Revert(); // We are not allowed to do completion, revert the change. } ////// Abandons the changes made during the editing scope. If the /// group has already been committed or aborted, this will /// throw an InvalidOperationException. Calling Revert calls /// the protected OnRevert with �false� for the /// finalizing parameter. /// ///If ModelEditingScope /// has already been committed. [SuppressMessage("Microsoft.Usage", "CA1816:CallGCSuppressFinalizeCorrectly", Justification = "By design.")] [SuppressMessage("Microsoft.Design", "CA1031:DoNotCatchGeneralExceptionTypes", Justification = "By design.")] public void Revert() { if (_completed) throw FxTrace.Exception.AsError(new InvalidOperationException(System.Activities.Presentation.Internal.Properties.Resources.Error_EdtingScopeCompleted)); if (_reverted) return; bool successful = false; _reverted = true; try { OnRevert(false); successful = true; } catch(Exception e) { _reverted = false; if (Fx.IsFatal(e)) { throw; } if (!OnException(e)) { throw; } } finally { if (successful) { GC.SuppressFinalize(this); } else { _reverted = false; } } } ////// Implements IDisposable.Dispose as follows: /// /// 1. If the editing scope has already been completed or reverted, do nothing. /// 2. Revert the editing scope. /// /// GC.SuppressFinalize(this) is called through Revert(), so suppress the FxCop violation. [System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Performance", "CA1816:DisposeMethodsShouldCallSuppressFinalize")] public void Dispose() { Dispose(true); } ////// Disposes this object by aborting changes. /// /// protected virtual void Dispose(bool disposing) { if (!_completed && !_reverted) { if (disposing) { Revert(); } else { OnRevert(true); } } } ////// Performs the actual complete of the editing scope. /// protected abstract void OnComplete(); ////// Determines if OnComplete should be called, or if the change should instead be reverted. Reasons /// for reverting may include file cannot be checked out of a source control system for modification. /// ///Returns true if completion can occur, false if the change should instead revert protected abstract bool CanComplete(); ////// Performs the actual revert of the editing scope. /// /// /// True if the abort is ocurring because the object /// is being finalized. Some undo systems may attempt to /// abort in this case, while others may abandon the /// change and record it as a reactive undo. /// protected abstract void OnRevert(bool finalizing); ////// Handle the exception during Complete and Revert. /// /// /// The exception to handle. /// ////// True if the exception is handled, false if otherwise /// protected abstract bool OnException(Exception exception); } } // File provided for Reference Use Only by Microsoft Corporation (c) 2007.
Link Menu
This book is available now!
Buy at Amazon US or
Buy at Amazon UK
- QueryRewriter.cs
- TransactionFlowElement.cs
- XPathNodeInfoAtom.cs
- SerializationStore.cs
- DataBoundLiteralControl.cs
- CodeSpit.cs
- TypeName.cs
- EdmComplexPropertyAttribute.cs
- SessionStateContainer.cs
- SHA256.cs
- CompilationSection.cs
- LambdaCompiler.Unary.cs
- DropShadowBitmapEffect.cs
- CompilationSection.cs
- CompositeKey.cs
- StorageComplexPropertyMapping.cs
- DisableDpiAwarenessAttribute.cs
- CaseCqlBlock.cs
- StorageAssociationTypeMapping.cs
- CodeGeneratorOptions.cs
- DataGridViewSelectedCellCollection.cs
- WSDualHttpBindingElement.cs
- MemoryFailPoint.cs
- CapabilitiesPattern.cs
- Model3DCollection.cs
- IndexedString.cs
- _HelperAsyncResults.cs
- Rectangle.cs
- SafeJobHandle.cs
- TraceContextEventArgs.cs
- PackageFilter.cs
- basecomparevalidator.cs
- JapaneseLunisolarCalendar.cs
- ImpersonationContext.cs
- XmlArrayItemAttributes.cs
- Marshal.cs
- LogEntryDeserializer.cs
- LayoutTable.cs
- SHA256Managed.cs
- FixedDSBuilder.cs
- ReceiveActivityDesignerTheme.cs
- Selector.cs
- PngBitmapDecoder.cs
- ProfileProvider.cs
- RevocationPoint.cs
- WmlSelectionListAdapter.cs
- RSAOAEPKeyExchangeDeformatter.cs
- PointLightBase.cs
- BorderSidesEditor.cs
- InlineCollection.cs
- TokenBasedSet.cs
- HMACMD5.cs
- DefaultTraceListener.cs
- CompressEmulationStream.cs
- StructuredProperty.cs
- DefaultBindingPropertyAttribute.cs
- SrgsElement.cs
- ButtonColumn.cs
- BaseTreeIterator.cs
- ThreadStaticAttribute.cs
- CopyOnWriteList.cs
- ConnectAlgorithms.cs
- SrgsElement.cs
- TableRow.cs
- RowVisual.cs
- CodeArrayIndexerExpression.cs
- XXXInfos.cs
- Equal.cs
- TableCell.cs
- SiteMapPath.cs
- LifetimeServices.cs
- ConditionalWeakTable.cs
- HtmlMeta.cs
- TableLayoutCellPaintEventArgs.cs
- ControlBuilderAttribute.cs
- SqlGenerator.cs
- LineVisual.cs
- NotifyParentPropertyAttribute.cs
- XmlILConstructAnalyzer.cs
- NotifyParentPropertyAttribute.cs
- Choices.cs
- FactoryGenerator.cs
- ZipIORawDataFileBlock.cs
- DoubleLinkList.cs
- TableLayoutStyleCollection.cs
- SafeBuffer.cs
- RegexMatch.cs
- MatrixValueSerializer.cs
- WebServiceData.cs
- StylusPointCollection.cs
- XmlSchemaDocumentation.cs
- SecurityToken.cs
- EnumValAlphaComparer.cs
- GACIdentityPermission.cs
- RenderTargetBitmap.cs
- ListItem.cs
- ClosableStream.cs
- TreeNode.cs
- ConnectionInterfaceCollection.cs
- RSAOAEPKeyExchangeFormatter.cs