Exportar (0) Imprimir
Expandir todo
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original

DependencyObject.SetValue (Método) (DependencyProperty, Object)

Establece el valor local de una propiedad de dependencia, especificado por su identificador de propiedad de dependencia.

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

public void SetValue(
	DependencyProperty dp,
	Object value
)

Parámetros

dp
Tipo: System.Windows.DependencyProperty
Identificador de la propiedad de dependencia que se va a establecer.
value
Tipo: System.Object
Nuevo valor local.

ExcepciónCondición
InvalidOperationException

Se intentó modificar una propiedad de dependencia de sólo lectura o una propiedad en un DependencyObject sellado.

ArgumentException

value no era el tipo correcto registrado para la propiedad dp.

Si el tipo proporcionado no coincide con el tipo declarado para la propiedad de dependencia tal como se registró originalmente, se produce una excepción. El parámetro value siempre se debe proporcionar como el tipo adecuado.

Las condiciones de excepción se pueden ver afectadas por la devolución de llamada ValidateValueCallback que existe en el identificador de la propiedad de dependencia que se va a establecer. De lo contrario, el valor proporcionado podría producir un error en las condiciones de comprobación de tipos generales (por ejemplo, cuando se pasa una cadena y el tipo nativo es Double).

This example shows how to back a common language runtime (CLR) property with a DependencyProperty field, thus defining a dependency property. When you define your own properties and want them to support many aspects of Windows Presentation Foundation (WPF) functionality, including styles, data binding, inheritance, animation, and default values, you should implement them as a dependency property.

The following example first registers a dependency property by calling the Register method. The name of the identifier field that you use to store the name and characteristics of the dependency property must be the Name you chose for the dependency property as part of the Register call, appended by the literal string Property. For instance, if you register a dependency property with a Name of Location, then the identifier field that you define for the dependency property must be named LocationProperty.

In this example, the name of the dependency property and its CLR accessor is State; the identifier field is StateProperty; the type of the property is Boolean; and the type that registers the dependency property is MyStateControl.

If you fail to follow this naming pattern, designers might not report your property correctly, and certain aspects of property system style application might not behave as expected.

You can also specify default metadata for a dependency property. This example registers the default value of the State dependency property to be false.


public class MyStateControl : ButtonBase
{
  public MyStateControl() : base() { }
  public Boolean State
  {
    get { return (Boolean)this.GetValue(StateProperty); }
    set { this.SetValue(StateProperty, value); } 
  }
  public static readonly DependencyProperty StateProperty = DependencyProperty.Register(
    "State", typeof(Boolean), typeof(MyStateControl),new PropertyMetadata(false));
}


For more information about how and why to implement a dependency property, as opposed to just backing a CLR property with a private field, see Información general sobre las propiedades de dependencia.

.NET Framework

Compatible con: 4, 3.5, 3.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.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:
© 2015 Microsoft