在Winforms中将属性绑定到控件

Question

如何将一个属性绑定到一个控件，以便当属性值变化时，控件的绑定属性也会随之更改。

例如，如果我有一个名为FirstName的属性，我想将它绑定到文本框txtFirstName的文本值。那么，如果我将FirstName更改为“Stack”，那么txtFirstName.Text的属性值也会更改为“Stack”。

我知道这可能听起来是个愚蠢的问题，但我会感激你的帮助。

- cubski

Answer 1

您必须实现INotifyPropertyChanged并将其绑定到文本框。

我会提供C#代码片段。希望能帮到您。

class Sample : INotifyPropertyChanged
{
    private string firstName;
    public string FirstName
    {
        get { return firstName; }
        set
        {
            firstName = value;
            InvokePropertyChanged(new PropertyChangedEventArgs("FirstName"));
        }
    }

    #region Implementation of INotifyPropertyChanged

    public event PropertyChangedEventHandler PropertyChanged;

    public void InvokePropertyChanged(PropertyChangedEventArgs e)
    {
        PropertyChangedEventHandler handler = PropertyChanged;
        if (handler != null) handler(this, e);
    }

    #endregion
}

使用方法：

 Sample sourceObject = new Sample();
 textbox.DataBindings.Add("Text",sourceObject,"FirstName");
 sourceObject.FirstName = "Stack"; 

- Stecya

---

当 textBox.Text 改变时，这段代码将会更新 sourceObject。另外，为了在 sourceObject.FirstName 改变时更新文本框内容（这是原始问题），你还需要订阅 PropertyChanged 事件。 - David

@David - 这个可以双向工作。我刚刚创建了应用并测试了它。 - Stecya

@Stecya 这不完全正确。根据上面的例子，在我更改sourceObject.FirstName时它会起作用，当我更改UI中文本框中的文本并离开文本框时也会起作用。但是，当我在代码后端更新文本框的文本时，即通过执行textbox.Text = "Anything"，它将不会更新sourceObject中的属性。所以我认为绑定更新是由.NET在任何控件的内部“离开”事件触发的，是吗？如果我错了，请纠正我。对于我来说，这个案例还不足够。 - Martin Braun

要将控件中的更改绑定到属性上，请使用以下代码： textbox.DataBindings.Add("Text", sourceObject, "FirstName", false, DataSourceUpdateMode.OnPropertyChanged); 请注意，这不是解释，而是对原文进行的翻译。 - yatskovsky

很好。不过我建议使用一种自动获取属性名称的方法以方便您使用：protected void OnPropertyChanged() { if (PropertyChanged != null) PropertyChanged(this, new PropertyChangedEventArgs(new System.Diagnostics.StackFrame(1).GetMethod().Name.Replace("set_", ""))); } - Szybki

Answer 2

接受答案的简化版本，无需在每个属性设置器中手动输入属性名称，例如OnPropertyChanged("some-property-name")。而是只需调用没有参数的OnPropertyChanged()：

最低需要 .NET 4.5。 CallerMemberName在System.Runtime.CompilerServices命名空间中。

public class Sample : INotifyPropertyChanged
{
    private string _propString;
    private int _propInt;


    //======================================
    // Actual implementation
    //======================================
    public event PropertyChangedEventHandler PropertyChanged;

    [NotifyPropertyChangedInvocator]
    protected virtual void OnPropertyChanged([CallerMemberName] string propertyName = null)
    {
        var handler = PropertyChanged;
        if (handler != null) handler(this, new PropertyChangedEventArgs(propertyName));
    }
    //======================================
    // END: actual implementation
    //======================================


    public string PropString
    {
        get { return _propString; }
        set
        {
            // do not trigger change event if values are the same
            if (Equals(value, _propString)) return;
            _propString = value;

            //===================
            // Usage in the Source
            //===================
            OnPropertyChanged();

        }
    }

    public int PropInt
    {
        get { return _propInt; }
        set
        {
            // do not allow negative numbers, but always trigger a change event
            _propInt = value < 0 ? 0 : value;
            OnPropertyChanged();
        }
    }
}

使用方式保持不变：

var source = new Sample();
textbox.DataBindings.Add("Text", source, "PropString");
source.PropString = "Some new string";

希望这能帮助到有需要的人。

- Dmitry Avtonomov

---

我在“CallerMemberName”上遇到了一个错误。它需要在某个地方被定义吗？ - Antonio Mano

你需要至少 .NET 4.5 版本。CallerMemberName 在 System.Runtime.CompilerServices 命名空间中。 - Steven Bone

即使使用 .net 4.6.1 和 System.Runtime.CompilerServices 命名空间，[NotifyPropertyChangedInvocator] 仍不存在。 - Shadowblitz16

请参阅 https://dev59.com/UWAg5IYBdhLWcg3wwtRp。 - Dmitry Avtonomov