AnnotationStore.cs source code in C# .NET

                        
Code:
                         / Dotnetfx_Vista_SP2 / Dotnetfx_Vista_SP2 / 8.0.50727.4016 / DEVDIV / depot / DevDiv / releases / Orcas / QFE / wpf / src / Framework / System / Windows / Annotations / Storage / AnnotationStore.cs / 1 / AnnotationStore.cs
                        

                        
                            //------------------------------------------------------------------------------ 
//
// 
//    Copyright (C) Microsoft Corporation.  All rights reserved.
//  
//
// Description: 
//     The AnnotationStore abstract class provides the basic API for 
//     storing and retrieving annotations.
//     Spec: http://team/sites/ag/Specifications/CAF%20Storage%20Spec.doc 
//
// History:
//  10/04/2002: rruiz:    Added header comment to AnnotationStore.cs.
//  06/01/2003: LGolding: Ported to WCP tree. 
//  07/17/2003: rruiz:    Changed from interface to abstract class; updated API
//                        as per spec. 
// 
//-----------------------------------------------------------------------------
 
using System;
using System.Collections;
using System.Collections.Generic;
using System.Xml; 
using System.Windows.Annotations;
using System.Windows.Markup; 
 
namespace System.Windows.Annotations.Storage
{ 
    /// 

    ///     The AnnotationStore abstract class provides the basic API for
    ///     storing and retrieving annotations.
    /// 
 
    public abstract class AnnotationStore : IDisposable
    { 
        //----------------------------------------------------- 
        //
        //  Constructors 
        //
        //-----------------------------------------------------

        #region Constructors 

        /// 
 
        ///     Creates an instance of an annotation store. 
        /// 
        protected AnnotationStore() 
        {
        }

        /// 
 
        ///     Guarantees that Dispose() will eventually be called on this
        ///     instance. 
        /// 
 
        ~AnnotationStore()
        { 
            Dispose(false);
        }

        #endregion Constructors 

        //------------------------------------------------------ 
        // 
        //  Public Methods
        // 
        //-----------------------------------------------------

        #region Public Methods
 
        /// 

        ///     Add a new annotation to this store.  The new annotation's Id 
        ///     is set to a new value. 
        /// 
        /// the annotation to be added to the store 
        /// newAnnotation is null
        /// newAnnotation already exists in this store, as determined by its Id
        /// if object has been disposed
        public abstract void AddAnnotation(Annotation newAnnotation); 

        /// 
 
        ///     Delete the specified annotation. 
        /// 
        /// the Id of the annotation to be deleted 
        /// the annotation that was deleted
        /// if object has been disposed
        public abstract Annotation DeleteAnnotation(Guid annotationId);
 
        /// 

        ///     Queries the AnnotationStore for annotations that have an anchor 
        ///     that contains a locator that begins with the locator parts 
        ///     in anchorLocator.
        /// 
 
        /// the locator we are looking for
        /// 
        ///     A list of annotations that have locators in their anchors
        ///    starting with the same locator parts list as of the input locator 
        ///    Can return an empty list, but never null.
        ///  
        /// if object has been disposed 
        public abstract IList GetAnnotations(ContentLocator anchorLocator);
 
        /// 

        /// Returns a list of all annotations in the store
        /// 
        /// if object has been disposed 
        /// annotations list. Can return an empty list, but never null.
        public abstract IList  GetAnnotations(); 
 
        /// 

        /// Finds annotation by Id 
        /// 
        /// 
        /// if object has been disposed
        /// The annotation. Null if the annotation does not exists 
        public abstract Annotation GetAnnotation(Guid annotationId);
 
        /// 
 
        ///     Causes any buffered data to be written to the underlying storage
        ///     mechanism.  Gets called after each operation if 
        ///     AutoFlush is set to true.
        /// 
        /// 
        ///     Applications that have an explicit save model may choose to call 
        ///     this method directly when appropriate.  Applications that have an
        ///     implied save model, see AutoFlush. 
        ///  
        /// if object has been disposed
        ///  
        public abstract void Flush();

        /// 

        ///     Disposes of any managed and unmanaged resources used by this 
        ///     store.
        /// 
 
        public void Dispose() 
        {
            Dispose(true); 
            GC.SuppressFinalize(this);
        }

        #endregion Public Methods 

        //------------------------------------------------------ 
        // 
        //  Public Operators
        // 
        //------------------------------------------------------

        //-----------------------------------------------------
        // 
        //  Public Properties
        // 
        //------------------------------------------------------ 

        #region Public Properties 

        /// 

        ///     When set to true an implementation should call Flush()
        ///     as a side-effect after each operation. 
        /// 
        ///  
        ///     true if the implementation is set to call Flush() after 
        ///     each operation; false otherwise
        ///  
        public abstract bool AutoFlush { get; set; }

        #endregion Public Properties
 
        //-----------------------------------------------------
        // 
        //  Public Events 
        //
        //----------------------------------------------------- 

        #region Public Events

        /// 
 
        /// Event fired when annotations are added or deleted from the
        /// AnnotationStore. 
        /// 
 
        public event StoreContentChangedEventHandler StoreContentChanged;
 
        /// 

        /// Event fired when an author on any Annotation in this
        /// AnnotationStore changes.  This event is useful if you are
        /// interested in listening to all annotations from this store 
        /// without registering on each individually.
        /// 
 
        public event AnnotationAuthorChangedEventHandler AuthorChanged; 

        /// 
 
        /// Event fired when an anchor on any Annotation in this
        /// AnnotationStore changes.  This event is useful if you are
        /// interested in listening to all annotations from this store
        /// without registering on each individually. 
        /// 
        public event AnnotationResourceChangedEventHandler AnchorChanged; 
 
        /// 

        /// Event fired when a cargo on any Annotation in this 
        /// AnnotationStore changes.  This event is useful if you are
        /// interested in listening to all annotations from this store
        /// without registering on each individually.
        /// 
 
        public event AnnotationResourceChangedEventHandler CargoChanged;
 
        #endregion Public Events 

        //----------------------------------------------------- 
        //
        //  Protected Methods
        //
        //------------------------------------------------------ 

        #region Protected Methods 
 
        /// 

        ///     Disposes of the resources (other than memory) used by the store. 
        /// 
        /// true to release both managed and unmanaged
        /// resources; false to release only unmanaged resources
        protected virtual void Dispose(bool disposing) 
        {
            lock (SyncRoot) 
            { 
                if (!_disposed)
                { 
                    if (disposing)
                    {
                        // Do nothing here - subclasses will override this
                        // method and dispose of things as appropriate 
                    }
 
                    _disposed = true; 
                }
            } 
        }

        /// 

        ///     Should be called when any annotation's author changes. 
        ///     This will fire the AuthorChanged event and cause a flush
        ///     if AutoFlush is true. 
        /// 
 
        /// the args for the event
        protected virtual void OnAuthorChanged(AnnotationAuthorChangedEventArgs args) 
        {
            AnnotationAuthorChangedEventHandler authorChanged = null;

            // Ignore null authors added to an annotation 
            if (args.Author == null)
                return; 
 
            lock (SyncRoot)
            { 
                authorChanged = AuthorChanged;
            }

            if (AutoFlush) 
            {
                Flush(); 
            } 

            if (authorChanged != null) 
            {
                authorChanged(this, args);
            }
        } 

        /// 
 
        ///     Should be called when any annotation's anchor changes. 
        ///     This will fire the AnchorChanged event and cause a flush
        ///     if AutoFlush is true. 
        /// 
        /// the args for the event
        protected virtual void OnAnchorChanged(AnnotationResourceChangedEventArgs args)
        { 
            AnnotationResourceChangedEventHandler anchorChanged = null;
 
            // Ignore null resources added to an annotation 
            if (args.Resource == null)
                return; 

            lock (SyncRoot)
            {
                anchorChanged = AnchorChanged; 
            }
 
            if (AutoFlush) 
            {
                Flush(); 
            }

            if (anchorChanged != null)
            { 
                anchorChanged(this, args);
            } 
        } 

        /// 
 
        ///     Should be called when any annotation's cargo changes.
        ///     This will fire the CargoChanged event and cause a flush
        ///     if AutoFlush is true.
        /// 
 
        /// the args for the event
        protected virtual void OnCargoChanged(AnnotationResourceChangedEventArgs args) 
        { 
            AnnotationResourceChangedEventHandler cargoChanged = null;
 
            // Ignore null resources added to an annotation
            if (args.Resource == null)
                return;
 
            lock (SyncRoot)
            { 
                cargoChanged = CargoChanged; 
            }
 
            if (AutoFlush)
            {
                Flush();
            } 

            if (cargoChanged != null) 
            { 
                cargoChanged(this, args);
            } 
        }

        /// 

        ///     Should be called after every operation in order to trigger 
        ///     events and to perform an automatic flush if AutoFlush is true.
        /// 
 
        /// arguments for the event to fire 
        protected virtual void OnStoreContentChanged(StoreContentChangedEventArgs e)
        { 
            StoreContentChangedEventHandler storeContentChanged = null;

            lock (SyncRoot)
            { 
                storeContentChanged = StoreContentChanged;
            } 
 
            if (AutoFlush)
            { 
                Flush();
            }

            if (storeContentChanged != null) 
            {
                storeContentChanged(this, e); 
            } 
        }
 
        #endregion Protected Methods

        //-----------------------------------------------------
        // 
        //  Protected Properties
        // 
        //------------------------------------------------------ 

        #region Protected Properties 

        /// 

        /// This object should be used for synchronization
        /// by all AnnotationStore implementations 
        /// 
        /// the lock object 
        protected object SyncRoot 
        {
            get 
            {
                return lockObject;
            }
        } 

        /// 
 
        /// Is this store disposed 
        /// 
        ///  
        protected bool IsDisposed
        {
            get
            { 
                return _disposed;
            } 
        } 

        #endregion Protected Properties 

        //------------------------------------------------------
        //
        //  Private Fields 
        //
        //----------------------------------------------------- 
 
        #region Private Fields
 
        // Tracks the state of this store - closed or not
        private bool _disposed = false;

        /// Private object used for synchronization 
        private Object lockObject = new Object();
 
        #endregion Private Fields 
    }
} 

// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
// Copyright (c) Microsoft Corporation. All rights reserved.
//------------------------------------------------------------------------------ 
//
// 
//    Copyright (C) Microsoft Corporation.  All rights reserved.
//  
//
// Description: 
//     The AnnotationStore abstract class provides the basic API for 
//     storing and retrieving annotations.
//     Spec: http://team/sites/ag/Specifications/CAF%20Storage%20Spec.doc 
//
// History:
//  10/04/2002: rruiz:    Added header comment to AnnotationStore.cs.
//  06/01/2003: LGolding: Ported to WCP tree. 
//  07/17/2003: rruiz:    Changed from interface to abstract class; updated API
//                        as per spec. 
// 
//-----------------------------------------------------------------------------
 
using System;
using System.Collections;
using System.Collections.Generic;
using System.Xml; 
using System.Windows.Annotations;
using System.Windows.Markup; 
 
namespace System.Windows.Annotations.Storage
{ 
    /// 

    ///     The AnnotationStore abstract class provides the basic API for
    ///     storing and retrieving annotations.
    /// 
 
    public abstract class AnnotationStore : IDisposable
    { 
        //----------------------------------------------------- 
        //
        //  Constructors 
        //
        //-----------------------------------------------------

        #region Constructors 

        /// 
 
        ///     Creates an instance of an annotation store. 
        /// 
        protected AnnotationStore() 
        {
        }

        /// 
 
        ///     Guarantees that Dispose() will eventually be called on this
        ///     instance. 
        /// 
 
        ~AnnotationStore()
        { 
            Dispose(false);
        }

        #endregion Constructors 

        //------------------------------------------------------ 
        // 
        //  Public Methods
        // 
        //-----------------------------------------------------

        #region Public Methods
 
        /// 

        ///     Add a new annotation to this store.  The new annotation's Id 
        ///     is set to a new value. 
        /// 
        /// the annotation to be added to the store 
        /// newAnnotation is null
        /// newAnnotation already exists in this store, as determined by its Id
        /// if object has been disposed
        public abstract void AddAnnotation(Annotation newAnnotation); 

        /// 
 
        ///     Delete the specified annotation. 
        /// 
        /// the Id of the annotation to be deleted 
        /// the annotation that was deleted
        /// if object has been disposed
        public abstract Annotation DeleteAnnotation(Guid annotationId);
 
        /// 

        ///     Queries the AnnotationStore for annotations that have an anchor 
        ///     that contains a locator that begins with the locator parts 
        ///     in anchorLocator.
        /// 
 
        /// the locator we are looking for
        /// 
        ///     A list of annotations that have locators in their anchors
        ///    starting with the same locator parts list as of the input locator 
        ///    Can return an empty list, but never null.
        ///  
        /// if object has been disposed 
        public abstract IList GetAnnotations(ContentLocator anchorLocator);
 
        /// 

        /// Returns a list of all annotations in the store
        /// 
        /// if object has been disposed 
        /// annotations list. Can return an empty list, but never null.
        public abstract IList  GetAnnotations(); 
 
        /// 

        /// Finds annotation by Id 
        /// 
        /// 
        /// if object has been disposed
        /// The annotation. Null if the annotation does not exists 
        public abstract Annotation GetAnnotation(Guid annotationId);
 
        /// 
 
        ///     Causes any buffered data to be written to the underlying storage
        ///     mechanism.  Gets called after each operation if 
        ///     AutoFlush is set to true.
        /// 
        /// 
        ///     Applications that have an explicit save model may choose to call 
        ///     this method directly when appropriate.  Applications that have an
        ///     implied save model, see AutoFlush. 
        ///  
        /// if object has been disposed
        ///  
        public abstract void Flush();

        /// 

        ///     Disposes of any managed and unmanaged resources used by this 
        ///     store.
        /// 
 
        public void Dispose() 
        {
            Dispose(true); 
            GC.SuppressFinalize(this);
        }

        #endregion Public Methods 

        //------------------------------------------------------ 
        // 
        //  Public Operators
        // 
        //------------------------------------------------------

        //-----------------------------------------------------
        // 
        //  Public Properties
        // 
        //------------------------------------------------------ 

        #region Public Properties 

        /// 

        ///     When set to true an implementation should call Flush()
        ///     as a side-effect after each operation. 
        /// 
        ///  
        ///     true if the implementation is set to call Flush() after 
        ///     each operation; false otherwise
        ///  
        public abstract bool AutoFlush { get; set; }

        #endregion Public Properties
 
        //-----------------------------------------------------
        // 
        //  Public Events 
        //
        //----------------------------------------------------- 

        #region Public Events

        /// 
 
        /// Event fired when annotations are added or deleted from the
        /// AnnotationStore. 
        /// 
 
        public event StoreContentChangedEventHandler StoreContentChanged;
 
        /// 

        /// Event fired when an author on any Annotation in this
        /// AnnotationStore changes.  This event is useful if you are
        /// interested in listening to all annotations from this store 
        /// without registering on each individually.
        /// 
 
        public event AnnotationAuthorChangedEventHandler AuthorChanged; 

        /// 
 
        /// Event fired when an anchor on any Annotation in this
        /// AnnotationStore changes.  This event is useful if you are
        /// interested in listening to all annotations from this store
        /// without registering on each individually. 
        /// 
        public event AnnotationResourceChangedEventHandler AnchorChanged; 
 
        /// 

        /// Event fired when a cargo on any Annotation in this 
        /// AnnotationStore changes.  This event is useful if you are
        /// interested in listening to all annotations from this store
        /// without registering on each individually.
        /// 
 
        public event AnnotationResourceChangedEventHandler CargoChanged;
 
        #endregion Public Events 

        //----------------------------------------------------- 
        //
        //  Protected Methods
        //
        //------------------------------------------------------ 

        #region Protected Methods 
 
        /// 

        ///     Disposes of the resources (other than memory) used by the store. 
        /// 
        /// true to release both managed and unmanaged
        /// resources; false to release only unmanaged resources
        protected virtual void Dispose(bool disposing) 
        {
            lock (SyncRoot) 
            { 
                if (!_disposed)
                { 
                    if (disposing)
                    {
                        // Do nothing here - subclasses will override this
                        // method and dispose of things as appropriate 
                    }
 
                    _disposed = true; 
                }
            } 
        }

        /// 

        ///     Should be called when any annotation's author changes. 
        ///     This will fire the AuthorChanged event and cause a flush
        ///     if AutoFlush is true. 
        /// 
 
        /// the args for the event
        protected virtual void OnAuthorChanged(AnnotationAuthorChangedEventArgs args) 
        {
            AnnotationAuthorChangedEventHandler authorChanged = null;

            // Ignore null authors added to an annotation 
            if (args.Author == null)
                return; 
 
            lock (SyncRoot)
            { 
                authorChanged = AuthorChanged;
            }

            if (AutoFlush) 
            {
                Flush(); 
            } 

            if (authorChanged != null) 
            {
                authorChanged(this, args);
            }
        } 

        /// 
 
        ///     Should be called when any annotation's anchor changes. 
        ///     This will fire the AnchorChanged event and cause a flush
        ///     if AutoFlush is true. 
        /// 
        /// the args for the event
        protected virtual void OnAnchorChanged(AnnotationResourceChangedEventArgs args)
        { 
            AnnotationResourceChangedEventHandler anchorChanged = null;
 
            // Ignore null resources added to an annotation 
            if (args.Resource == null)
                return; 

            lock (SyncRoot)
            {
                anchorChanged = AnchorChanged; 
            }
 
            if (AutoFlush) 
            {
                Flush(); 
            }

            if (anchorChanged != null)
            { 
                anchorChanged(this, args);
            } 
        } 

        /// 
 
        ///     Should be called when any annotation's cargo changes.
        ///     This will fire the CargoChanged event and cause a flush
        ///     if AutoFlush is true.
        /// 
 
        /// the args for the event
        protected virtual void OnCargoChanged(AnnotationResourceChangedEventArgs args) 
        { 
            AnnotationResourceChangedEventHandler cargoChanged = null;
 
            // Ignore null resources added to an annotation
            if (args.Resource == null)
                return;
 
            lock (SyncRoot)
            { 
                cargoChanged = CargoChanged; 
            }
 
            if (AutoFlush)
            {
                Flush();
            } 

            if (cargoChanged != null) 
            { 
                cargoChanged(this, args);
            } 
        }

        /// 

        ///     Should be called after every operation in order to trigger 
        ///     events and to perform an automatic flush if AutoFlush is true.
        /// 
 
        /// arguments for the event to fire 
        protected virtual void OnStoreContentChanged(StoreContentChangedEventArgs e)
        { 
            StoreContentChangedEventHandler storeContentChanged = null;

            lock (SyncRoot)
            { 
                storeContentChanged = StoreContentChanged;
            } 
 
            if (AutoFlush)
            { 
                Flush();
            }

            if (storeContentChanged != null) 
            {
                storeContentChanged(this, e); 
            } 
        }
 
        #endregion Protected Methods

        //-----------------------------------------------------
        // 
        //  Protected Properties
        // 
        //------------------------------------------------------ 

        #region Protected Properties 

        /// 

        /// This object should be used for synchronization
        /// by all AnnotationStore implementations 
        /// 
        /// the lock object 
        protected object SyncRoot 
        {
            get 
            {
                return lockObject;
            }
        } 

        /// 
 
        /// Is this store disposed 
        /// 
        ///  
        protected bool IsDisposed
        {
            get
            { 
                return _disposed;
            } 
        } 

        #endregion Protected Properties 

        //------------------------------------------------------
        //
        //  Private Fields 
        //
        //----------------------------------------------------- 
 
        #region Private Fields
 
        // Tracks the state of this store - closed or not
        private bool _disposed = false;

        /// Private object used for synchronization 
        private Object lockObject = new Object();
 
        #endregion Private Fields 
    }
} 

// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
// Copyright (c) Microsoft Corporation. All rights reserved.

                        

                        

                        
                        

Link Menu

This book is available now!
Buy at Amazon US or
Buy at Amazon UK

• HtmlTable.cs
• OdbcRowUpdatingEvent.cs
• ArraySegment.cs
• PropertyStore.cs
• MatchingStyle.cs
• ExpandCollapsePattern.cs
• SqlCachedBuffer.cs
• InternalConfigSettingsFactory.cs
• GenericPrincipal.cs
• AgileSafeNativeMemoryHandle.cs
• WebBrowserContainer.cs
• XmlSignificantWhitespace.cs
• XsdSchemaFileEditor.cs
• PrefixQName.cs
• XPathAncestorQuery.cs
• RequestCachePolicy.cs
• CallTemplateAction.cs
• MemoryPressure.cs
• UrlMappingsModule.cs
• SqlFactory.cs
• EnumType.cs
• KeyValuePairs.cs
• LineBreakRecord.cs
• metadatamappinghashervisitor.cs
• SectionInformation.cs
• UpdateCommand.cs
• DrawingContext.cs
• FtpWebRequest.cs
• InternalControlCollection.cs
• Internal.cs
• NonVisualControlAttribute.cs
• DataGridToolTip.cs
• WindowsSpinner.cs
• HtmlTextArea.cs
• TextSelectionProcessor.cs
• AssemblyBuilder.cs
• DbDataAdapter.cs
• X509ClientCertificateAuthentication.cs
• DataGridGeneralPage.cs
• FocusWithinProperty.cs
• XamlInterfaces.cs
• UpDownBase.cs
• ChannelDispatcher.cs
• TypeConverter.cs
• AnimatedTypeHelpers.cs
• ValidationErrorEventArgs.cs
• CqlQuery.cs
• UserPreferenceChangingEventArgs.cs
• ResourcePermissionBase.cs
• XamlBrushSerializer.cs
• StrokeRenderer.cs
• SmtpMail.cs
• StringComparer.cs
• GCHandleCookieTable.cs
• AddInPipelineAttributes.cs
• ContentElement.cs
• InputMethod.cs
• TrackingParameters.cs
• DragCompletedEventArgs.cs
• ItemCheckEvent.cs
• log.cs
• ServiceDescriptionSerializer.cs
• Authorization.cs
• WinEventTracker.cs
• StartUpEventArgs.cs
• CultureInfoConverter.cs
• ValidationEventArgs.cs
• HierarchicalDataBoundControl.cs
• CryptoApi.cs
• MultiView.cs
• GridEntryCollection.cs
• DesignerUtility.cs
• RowToFieldTransformer.cs
• ScrollItemProviderWrapper.cs
• PropertyGeneratedEventArgs.cs
• Simplifier.cs
• Geometry3D.cs
• WorkingDirectoryEditor.cs
• XslVisitor.cs
• ServiceModelReg.cs
• HttpWebRequest.cs
• DbConnectionStringCommon.cs
• DataShape.cs
• __Filters.cs
• DesignerWithHeader.cs
• TextBox.cs
• WeakRefEnumerator.cs
• CodeRegionDirective.cs
• SQlBooleanStorage.cs
• UnhandledExceptionEventArgs.cs
• RbTree.cs
• Int32Animation.cs
• IndexedEnumerable.cs
• CopyOfAction.cs
• PerformanceCounter.cs
• MessageQueueConverter.cs
• DataBoundControlActionList.cs
• DetailsViewInsertEventArgs.cs
• DesignerWithHeader.cs
• DbUpdateCommandTree.cs