ConnectionStringEditor.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 by using 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 to use to gain additional context information.
- provider
- IServiceProvider
A service provider object through which to obtain editing services.
- value
- Object
An instance of the object being edited.
Returns
The selected connection expression, as a string object; otherwise, if a connection expression was not selected, the same value
that was passed in.
Remarks
The EditValue method starts the user interface for editing the value
object. The designer host calls the EditValue method when you edit the value of a property that the connection string editor is associated with. The input service provider is used to obtain any editing services that are required within the EditValue method.
If an IDataEnvironment service implementation is supported in the specified context, the EditValue method initializes a ListBox control, which prompts you to select an existing connection expression or build a new connection expression. If an IDataEnvironment service implementation is not supported in the specified context, the EditValue method displays a simple instance of the Form class, which prompts you to enter the connection expression string.
If you cancel without selecting a connection expression string, the returned object is the same as the value
parameter.