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

• ScrollBar.cs
• CodeValidator.cs
• ISAPIApplicationHost.cs
• Group.cs
• ToolStripDropTargetManager.cs
• TextPenaltyModule.cs
• Timeline.cs
• SemanticResolver.cs
• basecomparevalidator.cs
• TemplateParser.cs
• XmlSchemaObjectCollection.cs
• HtmlCalendarAdapter.cs
• IRCollection.cs
• GraphicsContainer.cs
• Storyboard.cs
• FlowDocumentReaderAutomationPeer.cs
• VerticalConnector.xaml.cs
• SafeFileHandle.cs
• BinaryObjectWriter.cs
• GifBitmapEncoder.cs
• PopOutPanel.cs
• VectorConverter.cs
• CopyOfAction.cs
• NativeWindow.cs
• SemaphoreSecurity.cs
• ObjRef.cs
• SqlDataSourceEnumerator.cs
• MimeFormImporter.cs
• LoginCancelEventArgs.cs
• DesignerTextBoxAdapter.cs
• SQLBytes.cs
• InnerItemCollectionView.cs
• ScriptingWebServicesSectionGroup.cs
• SoapEnvelopeProcessingElement.cs
• MimeWriter.cs
• DbInsertCommandTree.cs
• Dictionary.cs
• TimeoutConverter.cs
• SerialPort.cs
• Task.cs
• webbrowsersite.cs
• SapiRecoContext.cs
• DeclarativeCatalogPart.cs
• TextChange.cs
• CompilerHelpers.cs
• DataGridViewRowConverter.cs
• DataTableNewRowEvent.cs
• AutoResetEvent.cs
• RelationshipNavigation.cs
• LinqDataSourceDeleteEventArgs.cs
• TreeViewCancelEvent.cs
• HandleValueEditor.cs
• PersistenceProviderDirectory.cs
• TextServicesLoader.cs
• SapiRecoInterop.cs
• Size3D.cs
• ViewLoader.cs
• DrawingBrush.cs
• TableRowCollection.cs
• LayoutTable.cs
• AsynchronousChannel.cs
• Effect.cs
• UnsafeNativeMethods.cs
• GridView.cs
• FixedNode.cs
• CancellationTokenSource.cs
• DataGridCaption.cs
• PropertyRef.cs
• UrlPath.cs
• CroppedBitmap.cs
• ApplicationBuildProvider.cs
• ContextMenuService.cs
• PingOptions.cs
• LoginCancelEventArgs.cs
• FilteredDataSetHelper.cs
• SignedInfo.cs
• BrowserDefinition.cs
• ReadOnlyState.cs
• AccessDataSourceView.cs
• CellParaClient.cs
• Processor.cs
• Activator.cs
• WindowsTreeView.cs
• SmiRecordBuffer.cs
• AgileSafeNativeMemoryHandle.cs
• TypeSystemHelpers.cs
• SerializationStore.cs
• HealthMonitoringSectionHelper.cs
• ControlPaint.cs
• Attachment.cs
• unitconverter.cs
• ByeOperationAsyncResult.cs
• SqlClientWrapperSmiStream.cs
• ReturnEventArgs.cs
• NonBatchDirectoryCompiler.cs
• CalendarButton.cs
• JavaScriptSerializer.cs
• WebMessageFormatHelper.cs
• TickBar.cs
• StorageRoot.cs