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
- ConfigXmlComment.cs
- WebServiceReceive.cs
- SecurityPermission.cs
- exports.cs
- DefaultBindingPropertyAttribute.cs
- XmlDataImplementation.cs
- CTreeGenerator.cs
- storepermissionattribute.cs
- MergeFailedEvent.cs
- WorkflowOperationContext.cs
- Transform.cs
- SkinBuilder.cs
- BuildProviderAppliesToAttribute.cs
- HwndSource.cs
- EndEvent.cs
- MarshalByRefObject.cs
- GroupDescription.cs
- AbstractExpressions.cs
- Rotation3DAnimationBase.cs
- InternalPermissions.cs
- LiteralText.cs
- HandledEventArgs.cs
- Brush.cs
- ScrollEventArgs.cs
- ImageFormat.cs
- SessionEndedEventArgs.cs
- TargetInvocationException.cs
- _HeaderInfo.cs
- sqlnorm.cs
- JulianCalendar.cs
- ConnectionManagementSection.cs
- CompilationPass2Task.cs
- SelectionProviderWrapper.cs
- EventProxy.cs
- Line.cs
- RectValueSerializer.cs
- RSAOAEPKeyExchangeFormatter.cs
- CookieHandler.cs
- DataSpaceManager.cs
- DataGridItemEventArgs.cs
- OutKeywords.cs
- FloatSumAggregationOperator.cs
- ResXResourceSet.cs
- XPathSingletonIterator.cs
- ZipPackage.cs
- BackgroundFormatInfo.cs
- CodeStatementCollection.cs
- DebuggerService.cs
- Annotation.cs
- ComplexPropertyEntry.cs
- StopStoryboard.cs
- WorkflowMessageEventArgs.cs
- AdPostCacheSubstitution.cs
- datacache.cs
- UpdateEventArgs.cs
- TextBoxAutoCompleteSourceConverter.cs
- Translator.cs
- DbException.cs
- FamilyMapCollection.cs
- DataGridViewBand.cs
- ButtonPopupAdapter.cs
- XmlSerializerSection.cs
- PersonalizationStateInfo.cs
- PhysicalAddress.cs
- ProviderConnectionPointCollection.cs
- WebPartCatalogAddVerb.cs
- DefaultTraceListener.cs
- Lazy.cs
- HttpCookiesSection.cs
- IISMapPath.cs
- GlobalEventManager.cs
- Rect3DValueSerializer.cs
- PhysicalFontFamily.cs
- NumberFormatter.cs
- DebuggerAttributes.cs
- SymmetricSecurityProtocolFactory.cs
- Compiler.cs
- CompiledQueryCacheKey.cs
- Misc.cs
- ExclusiveHandle.cs
- EncryptedData.cs
- WebCategoryAttribute.cs
- GridItemCollection.cs
- DbLambda.cs
- InkSerializer.cs
- ModelTreeEnumerator.cs
- PlainXmlWriter.cs
- ResizeGrip.cs
- TraceUtils.cs
- CalendarAutoFormat.cs
- CodeDefaultValueExpression.cs
- FormViewDeleteEventArgs.cs
- XmlSchemas.cs
- ResetableIterator.cs
- NoneExcludedImageIndexConverter.cs
- DataGridDetailsPresenterAutomationPeer.cs
- HttpRuntime.cs
- XmlSchemaAnnotated.cs
- ObjectConverter.cs
- SystemTcpStatistics.cs