DataConnectionDialog Class

Article
10/03/2012

Provides access to the Data Connection dialog box with which to obtain data connection information from users.

Inheritance Hierarchy

System.Object
Microsoft.VisualStudio.Data.DataConnectionDialog

Namespace: Microsoft.VisualStudio.Data
Assembly: Microsoft.VisualStudio.Data (in Microsoft.VisualStudio.Data.dll)

Syntax

'Declaration
Public MustInherit Class DataConnectionDialog _
    Implements IDisposable

public abstract class DataConnectionDialog : IDisposable

public ref class DataConnectionDialog abstract : IDisposable

[<AbstractClass>]
type DataConnectionDialog =  
    class 
        interface IDisposable 
    end

public abstract class DataConnectionDialog implements IDisposable

The DataConnectionDialog type exposes the following members.

Constructors

	Name	Description
	DataConnectionDialog	Class constructor.

Top

Properties

	Name	Description
	AcceptButtonText	Retrieves or sets the text displayed on the button the user clicks to accept the contents of the Data Connection dialog box, then returns from the ShowDialog method.
	AvailableProviders	Retrieves a collection of unique identifiers for DDEX providers that are currently available for selection in the Data Connection dialog box.
	AvailableSources	A collection of GUIDs representing DDEX data sources that should be available for display in the Data Connection dialog box.
	ChangeDataSourceHeaderLabel	Retrieves or sets a summary description appearing on the Data Source dialog box header when the user clicks on the Change... button.
	ChangeDataSourceTitle	Retrieves or sets the title of the Data Source dialog box, which can be shown when the user clicks the Change… button.
	ChooseDataSourceAcceptText	Retrieves or sets text that shows on the Data Source dialog box Accept button when it appears before the Data Connection dialog box.
	ChooseDataSourceHeaderLabel	Retrieves or sets text of the description that appears on the header of the Data Source dialog box when it appears before the Data Connection dialog box.
	ChooseDataSourceTitle	Retrieves or sets the title of the Data Source dialog box when it appears before the Data Connection dialog box.
	DisplayConnectionString	Retrieves or sets unencrypted connection information for display on the Data Connection dialog box for the specified data provider.
	EncryptedConnectionString	Retrieves or sets encrypted connection information for the dialog box for the specified data provider.
	HeaderLabel	Retrieves or sets a summary description that appears at the head of the Data Connection dialog box.
	SaveSelection	Retrieves or sets a value indicating whether the caller of the dialog box should persist the currently selected data source and DDEX provider combination.
	SelectedProvider	Retrieves or sets the data provider currently selected in the connection dialog box, using the data provider's GUID.
	SelectedSource	Retrieves or sets a GUID value indicating the current selected data source.
	Title	Retrieves or sets the string representing text shown on the connection dialog box title bar.

Top

Methods

	Name	Description
	AddAllSources	Adds all registered data sources for display on the Data Source dialog box.
	AddSources(Guid)	Enumerates through all registered data sources and associated data providers, and adds those that have a matching provider technology.
	AddSources(DataConnectionDialogFilterCallback)	Enumerates all registered data sources and their associated data providers, and conditionally adds source/provider combinations to the Data Connection dialog box based on logic in the supplied callback.
	Dispose()	Disposes of the current instance of the data connection dialog and releases managed resources.
	Dispose(Boolean)	Disposes of the current instance of the data connection dialog and releases managed resources.
	Equals	Determines whether the specified object is equal to the current object. (Inherited from Object.)
	Finalize	Releases unmanaged resources and performs other cleanup operations before the DataConnectionDialog object is reclaimed by garbage collection. (Overrides Object.Finalize().)
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	LoadExistingConfiguration	Configures the Data Connection dialog box with the specified existing DDEX provider and connection string, deriving the correct data source where possible.
	LoadProviderSelections	Loads information about which DDEX provider is selected by default for each data source.
	LoadSourceSelection	Loads information about which data source is currently selected.
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	OnVerifySettings	Raises the VerifySettings event.
	SaveProviderSelections	Saves information about which DDEX provider is selected by default for each data source.
	SaveSourceSelection	Saves information about which data source is currently selected.
	ShowDialog()	Shows the Data Connection dialog box with the selected data provider and connection string settings pre-populated.
	ShowDialog(Boolean)	Shows the Data Connection dialog box pre-populated with the data provider and connection string settings and returns an open connection based on the connection string settings.
	ToString	Returns a string that represents the current object. (Inherited from Object.)

Top

Events

	Name	Description
	VerifySettings	The event raised when a user attempts to accept the connection settings in the Data Connection dialog box.

Top

Fields

	Name	Description
	UnspecifiedSource	Represents an unspecified data source.

Top

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Share via