SetValue
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Sets the specified property to the specified value.
object.SetValue(propertyName, value)
Arguments
propertyName |
string The name of the property to set. |
value |
object The value to set the property to. |
Managed Equivalent
DependencyObject.SetValue - note that in the managed API, this method is exclusively for dependency properties, and requires a dependency property identifier (not just a name as a string).
Remarks
You can use the SetValue method to set the value of any Silverlight property. However, you generally do not need this method to set property values, because all Silverlight properties support a more direct property syntax in JavaScript.
You can also use SetValue to set the value of Silverlight attached properties such as Canvas.Left. In this case, the attached property name consists of the owner class name for the attached property, a dot, and the attached property name: object.SetValue("ownerType.propertyName",value). Attached properties also support a more direct property syntax, in the form object["ownerType.propertyName"] = value.
Example
The following JavaScript example shows how to set a property value by using both the SetValue method and typical property notation.
function onMouseEnter(sender, index)
{
// Set the property value using the SetValue method.
sender.setValue("opacity", 0.5);
// Set the property value using the equivalent "." notation.
sender.opacity = 0.5;
}
Applies To
Accessibility Object (Silverlight JSAPI)
BitmapImage (Silverlight 2)
Border (Silverlight 2)
Brush (abstract)
ColorKeyFrame (abstract)
DeepZoomImageTileSource (Silverlight 2)
DependencyObject (abstract)
DiscreteObjectKeyFrame (Silverlight 2)
DoubleKeyFrame (abstract)
Geometry (abstract)
MultiScaleImage (Silverlight 2)
ObjectAnimationUsingKeyFrames (Silverlight 2)
ObjectKeyFrameCollection (Silverlight 2)
PasswordBox (Silverlight 2)
PathSegment (abstract)
PointKeyFrame (abstract)
Popup (Silverlight 2)
StackPanel (Silverlight 2)
TextBox (Silverlight 2)
Timeline (abstract)