ExpressionsCollectionEditor.EditValue Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Edits the value of the specified object with the specified service provider and context.
public:
override System::Object ^ EditValue(System::ComponentModel::ITypeDescriptorContext ^ context, IServiceProvider ^ provider, System::Object ^ value);
public override object EditValue (System.ComponentModel.ITypeDescriptorContext context, IServiceProvider provider, object value);
override this.EditValue : System.ComponentModel.ITypeDescriptorContext * IServiceProvider * obj -> obj
Public Overrides Function EditValue (context As ITypeDescriptorContext, provider As IServiceProvider, value As Object) As Object
Parameters
- context
- ITypeDescriptorContext
An ITypeDescriptorContext object that can be used to gain additional context information such as the associated control.
- provider
- IServiceProvider
A service provider object through which editing services can be obtained.
- value
- Object
An instance of the object being edited.
Returns
An ExpressionBindingCollection object containing the selected expressions; otherwise, if no expressions are selected, the value
object.
Remarks
The EditValue method launches the user interface for editing the value
object. The designer host calls the EditValue method when you attempt to edit the value of a property that this editor is associated with. The input service provider is used to obtain any editing services that are required within the EditValue.
A designer host, such as Visual Studio 2005, uses the ExpressionBuilder and ExpressionEditor class implementations with the ExpressionsCollectionEditor and ExpressionsCollectionConverter classes to set the expression bindings for control properties at design time, and the ControlPersister class to persist the expressions for run time. Expression strings reference a localizable resource, an application setting, a connection string, or a custom expression type. The expression string is bound to the control property at design time, and then used at run time to determine the value for the property.
If users cancel the user interface without modifying the expression binding collection, the EditValue method returns the input value
parameter.