AnnotationStore.Flush Method

Definition

Namespace:

System.Windows.Annotations.Storage

Assembly:

PresentationFramework.dll

Forces any annotation data retained in internal buffers to be written to the underlying storage device.

C#

public abstract void Flush();

Exceptions

ObjectDisposedException

Dispose has been called on the store.

Examples

The following example shows how to use the Flush method when the application closes the AnnotationService.

C#

// -------------------------- StopAnnotations -------------------------
/// <summary>
///   Disables annotations processing and hides annotations.</summary>
public void StopAnnotations()
{
    // If the AnnotationStore is active, flush and close it.
    if ( (_annotService != null) && _annotService.IsEnabled )
    {
        _annotService.Store.Flush();
        _annotStream.Flush();
        _annotStream.Close();
    }

    // If the AnnotationService is active, shut it down.
    if (_annotService != null)
    {
        if (_annotService.IsEnabled)
            _annotService.Disable();
        _annotService = null;
    }
}// end:StopAnnotations()

The following example shows use of the DeleteAnnotation and Flush methods.

C#

// ------------------------- DeleteMark_Click -------------------------
void DeleteMark_Click(object sender, RoutedEventArgs e)
{
    Annotation ann = ((MenuItem)sender).Tag as Annotation;
    _annStore.DeleteAnnotation(ann.Id);
    _annStore.Flush();

    MenuItem thisMenu = sender as MenuItem;
    ContextMenu parentMenu = thisMenu.Parent as ContextMenu;
    FrameworkElement dObj =
        parentMenu.PlacementTarget as FrameworkElement;
    while (!(dObj is StackPanel))
    {
        dObj = dObj.Parent as FrameworkElement;
    }

    ListBox collection = dObj.Parent as ListBox;
    collection.Items.Remove(dObj);
    Util.FlushDispatcher();
}

Remarks

Applications that use an explicit-save model can set AutoFlush to false and call Flush directly when appropriate.

Applications that use an implicit-save model can set the AutoFlush to true to cause Flush to be called automatically after every store operation (add, delete, or modify).

Applies to

See also

• AutoFlush