ConnectionStringEditor.EditValue Method

Definition

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.

Applies to

See also