//------------------------------------------------------------------------------
// <copyright file="DataSourceUpdateMode.cs" company="Microsoft">
//     Copyright (c) Microsoft Corporation.  All rights reserved.
// </copyright>                                                                
//------------------------------------------------------------------------------
 
namespace System.Windows.Forms
{
    using System;
 
    /// <include file='doc\DataSourceUpdateMode.uex' path='docs/doc[@for="DataSourceUpdateMode"]/*' />
    /// <devdoc>
    ///     Determines when changes to a data-bound control property get propagated back to the corresponding data source property.
    /// </devdoc>
    public enum DataSourceUpdateMode {
 
        /// <include file='doc\DataSourceUpdateMode.uex' path='docs/doc[@for="DataSourceUpdateMode.OnValidation"]/*' />
        /// <devdoc>
        ///     Data source is updated when the control property is validated, ie. during the Validating event.
        ///     Typically this does not occur until the input focus leaves the control.
        ///     After validation, the value in the control property will also be re-formatted.
        ///     This is the default update mode.
        /// </devdoc>
        OnValidation = 0,
 
        /// <include file='doc\DataSourceUpdateMode.uex' path='docs/doc[@for="DataSourceUpdateMode.OnPropertyChanged"]/*' />
        /// <devdoc>
        ///     Data source is updated whenever the control property changes (and also updated again during validation).
        ///     After validation, the value in the control property will also be re-formatted.
        /// </devdoc>
        OnPropertyChanged = 1,
 
        /// <include file='doc\DataSourceUpdateMode.uex' path='docs/doc[@for="DataSourceUpdateMode.Never"]/*' />
        /// <devdoc>
        ///     Data source is never updated. Binding is "read-only" with respect to the data source.
        ///     Values entered into the control are *not* parsed, validated or re-formatted.
        ///     To force the data source to be updated, use the Binding.WriteValue method.
        /// </devdoc>
        Never = 2,
    }
}