Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

UpdateSourceTrigger (Enumeración)

describe el control de tiempo de las actualizaciones de origen de enlace .

Espacio de nombres:  System.Windows.Data
Ensamblado:  PresentationFramework (en PresentationFramework.dll)

public enum UpdateSourceTrigger
<object property="enumerationMemberName" .../>

Nombre de miembroDescripción
Defaultel valor predeterminado de UpdateSourceTrigger de la propiedad de destino de enlace . El valor predeterminado de la mayoría de propiedades de dependencia es PropertyChanged, mientras que la propiedad de Text tiene un valor predeterminado de LostFocus.

Una manera de determinar mediante programación el valor predeterminado de UpdateSourceTrigger de propiedad de dependencia es obtener los metadatos de la propiedad mediante GetMetadata y busque el valor de la propiedad de DefaultUpdateSourceTrigger .

ExplicitActualiza origen de enlace sólo cuando se llama al método de UpdateSource .
LostFocusActualiza origen de enlace siempre que el elemento de destino de enlace pierde el foco.
PropertyChangedActualiza origen de enlace inmediatamente siempre que cambia la propiedad de destino de enlace .

Para obtener más información, vea Binding.UpdateSourceTrigger.

En este tema se describe cómo utilizar la propiedad UpdateSourceTrigger para controlar el control de tiempo de las actualizaciones del origen de enlace. En el tema se utiliza el control TextBox como ejemplo.

El valor predeterminado de UpdateSourceTrigger de la propiedad TextBox.Text es LostFocus. Esto significa que si una aplicación tiene un objeto TextBox con una propiedad TextBox.Text enlazada a datos, el siguiente texto que se escriba en TextBox no actualizará el origen de enlace hasta que TextBox pierda el foco (por ejemplo, cuando haga clic fuera de TextBox).

Si desea que el origen se actualice a medida que se escribe, debe establecer la propiedad UpdateSourceTrigger del enlace en PropertyChanged. En el ejemplo siguiente, las propiedades Text de TextBox y de TextBlock están enlazadas a la misma propiedad de origen. La propiedad UpdateSourceTrigger del enlace de TextBox está establecida en PropertyChanged.


<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}"/>


Como resultado, TextBlock muestra el mismo texto (dado que el origen cambia) a medida que el usuario escribe texto en TextBox, como se muestra en la captura de pantalla siguiente del ejemplo:

Captura de pantalla de ejemplo de enlace de datos simple

Si tiene un cuadro de diálogo o un formulario modificable por el usuario y desea diferir las actualizaciones del origen hasta que el usuario haya terminado de modificar los campos y haga clic en "Aceptar", puede establecer el valor de UpdateSourceTrigger de los enlaces en Explicit, como en el ejemplo siguiente:


<TextBox Name="itemNameTextBox"
         Text="{Binding Path=ItemName, UpdateSourceTrigger=Explicit}" />


Cuando se establece el valor de UpdateSourceTrigger en Explicit, el valor del origen cambia únicamente cuando la aplicación llama al método UpdateSource. En el siguiente ejemplo se muestra cómo llamar a UpdateSource para itemNameTextBox.


// itemNameTextBox is an instance of a TextBox
BindingExpression be = itemNameTextBox.GetBindingExpression(TextBox.TextProperty);
be.UpdateSource();


NotaNota

Puede utilizar la misma técnica para las propiedades de otros controles, pero debe tener presente que el valor predeterminado de UpdateSourceTrigger de la mayoría de las demás propiedades es PropertyChanged. Para obtener más información, consulte la página de propiedades UpdateSourceTrigger.

NotaNota

La propiedad UpdateSourceTrigger se encarga de las actualizaciones del origen y, por consiguiente, únicamente es pertinente para los enlaces TwoWay o OneWayToSource. Para que los enlaces TwoWay y OneWayToSource funcionen, el objeto de origen debe proporcionar notificaciones de cambio de propiedad. Puede consultar los ejemplos citados en este tema para obtener más información. Además, puede consultar Cómo: Implementar la notificación de cambio de propiedad.

.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft