操作說明:TextBox 文字更新來源時控制
本主題描述如何使用 UpdateSourceTrigger 屬性來控制系結來源更新的時機。 本主題使用 TextBox 控制項作為範例。
範例
屬性 TextBox.Text 的預設值 UpdateSourceTrigger 為 LostFocus 。 這表示如果應用程式具有 TextBox 具有資料系結 TextBox.Text 屬性的 ,則您輸入 TextBox 的文字在失去焦點之前 TextBox 不會更新來源(例如,當您按一下遠離 TextBox 時)。
如果您想要在輸入時更新來源,請將系結的 設定 UpdateSourceTrigger 為 PropertyChanged 。 在下列範例中,反白顯示的程式程式碼會顯示 Text
和 TextBlock 的屬性 TextBox 都系結至相同的來源屬性。 系 UpdateSourceTrigger 結的 TextBox 屬性會設定為 PropertyChanged 。
<Window
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:src="clr-namespace:SDKSample"
xmlns:system="clr-namespace:System;assembly=mscorlib"
SizeToContent="WidthAndHeight"
Title="Simple Data Binding Sample">
<Window.Resources>
<ObjectDataProvider x:Key="myDataSource" ObjectType="{x:Type src:Person}">
<ObjectDataProvider.ConstructorParameters>
<system:String>Joe</system:String>
</ObjectDataProvider.ConstructorParameters>
</ObjectDataProvider>
<Style TargetType="{x:Type Label}">
<Setter Property="DockPanel.Dock" Value="Top"/>
<Setter Property="FontSize" Value="12"/>
</Style>
<Style TargetType="{x:Type TextBox}">
<Setter Property="Width" Value="100"/>
<Setter Property="Height" Value="25"/>
<Setter Property="DockPanel.Dock" Value="Top"/>
</Style>
<Style TargetType="{x:Type TextBlock}">
<Setter Property="Width" Value="100"/>
<Setter Property="Height" Value="25"/>
<Setter Property="DockPanel.Dock" Value="Top"/>
</Style>
</Window.Resources>
<Border Margin="25" BorderBrush="Aqua" BorderThickness="3" Padding="8">
<DockPanel Width="200" Height="100">
<Label>Enter a Name:</Label>
<TextBox>
<TextBox.Text>
<Binding Source="{StaticResource myDataSource}" Path="Name"
UpdateSourceTrigger="PropertyChanged"/>
</TextBox.Text>
</TextBox>
<Label>The name you entered:</Label>
<TextBlock Text="{Binding Source={StaticResource myDataSource}, Path=Name}"/>
</DockPanel>
</Border>
</Window>
因此,會顯示 TextBlock 與使用者輸入文字 TextBox 相同的文字(因為來源變更),如下列範例螢幕擷取畫面所示:
如果您有對話方塊或使用者可編輯的表單,而且您想要延遲來源更新,直到使用者完成編輯欄位,然後按一下 [確定],您可以將系結的值設定 UpdateSourceTrigger 為 Explicit ,如下列範例所示:
<TextBox Name="itemNameTextBox"
Text="{Binding Path=ItemName, UpdateSourceTrigger=Explicit}" />
當您將 UpdateSourceTrigger 值設定為 Explicit 時,來源值只會在應用程式呼叫 UpdateSource 方法時變更。 下列範例示範如何呼叫 UpdateSourceitemNameTextBox
:
// itemNameTextBox is an instance of a TextBox
BindingExpression be = itemNameTextBox.GetBindingExpression(TextBox.TextProperty);
be.UpdateSource();
Me.itemNameTextBox.GetBindingExpression(TextBox.TextProperty).UpdateSource()
Me.bidPriceTextBox.GetBindingExpression(TextBox.TextProperty).UpdateSource()
注意
您可以將相同的技巧用於其他控制項的屬性,但請記住,大部分其他屬性的預設值 UpdateSourceTriggerPropertyChanged 為 。 如需詳細資訊,請參閱 UpdateSourceTrigger 屬性頁。
注意
屬性 UpdateSourceTrigger 會處理來源更新,因此只會與 TwoWay 或 OneWayToSource 系結相關。 若要 TwoWay 讓 和 OneWayToSource 系結能夠運作,來源物件必須提供屬性變更通知。 如需詳細資訊,請參考本主題中引用的範例。 此外,您還可以參閱實作屬性變更通知。
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應