Export (0) Print
Expand All

Data Designer Extensibility Architecture 

Data Designer Extensibility (DDEX) provides a mechanism for extending data designers in Visual Studio to communicate with external data sources and expose their object hierarchies and allow hierarchy views in Server Explorer. DDEX allows access to external data source objects at design time, not only providing data object visibility in Visual Studio, but also enabling drag-and-drop functionality, object property grid visibility, and integration into features of the Visual Studio designers. In short, DDEX allows providers of third-party data sources to enjoy full citizenship in the Visual Studio design-time experience.

NoteNote

DDEX providers are different from .NET data providers. For more information, see DDEX Providers.

Data Designer Extensibility, then, is about using the DDEX SDK and the feature's architecture and managed APIs to integrate external data source objects into the Visual Studio environment.

NoteNote

This SDK should be used in conjunction with Visual Studio Development Environment SDK.

Architecture Overview

The illustration below provides a high-level, schematic view of the DDEX architecture. In it, you see that the DDEX client is hosted in Visual Studio 2005, and that it uses the access services (part of the DDEX managed class library) to communicate and interact with a DDEX provider. The DDEX provider itself is simply an implementation of the support entities, which are managed classes. DDEX then communicates with the data layer using a dedicated .NET data provider. Note, however, that the data provider can be omitted in cases where the DDEX provider is equipped with the capability needed to interact with the data source.

Ddex Architecture Graphic

Of the DDEX layer, two of its pieces are central: DDEX support entities, and DDEX access services

Support Entities and Access Services

DDEX support entities are managed classes that a DDEX provider implements to enable data extensibility. In fact, it is implementation of these support entities that constitutes a DDEX provider.

DDEX access services, on the other hand, are managed classes that Visual Studio calls to access functionality implemented by the DDEX provider as support entities. In other words, support entities and access services work hand-in-glove, as depicted in the illustration below.

API Mapping Image

Support Entities

The managed APIs that constitute a DDEX provider fall broadly into three categories:

  • Connection support

  • Data object support

  • Data view support

Connection Support

Connection support provides a way to specify connection information, including data source and connection string. This can be done either programmatically, if the connection information is known, or by using connection UI to prompt the user for the required connection information. Optionally, a DDEX provider can expose a connection control that is hosted in the Visual Studio connection dialog box.

Data Object Support

Using a data object support XML file, a DDEX provider defines data objects exposed by the data provider for a given data source. It also defines the object hierarchy, or object model, for these objects.

The Visual Studio metadata engine maintains a library of strongly typed classes that allow it to recognize generic data-source object like tables, views, and stored procedures, as well as generic object properties, all of which it reduces to concepts. The data object definitions provided in your XML file allows you to map object types supported by your data provider to one of these generic concepts that are recognized by the metadata engine.

In addition to defining object types and mapping them to generic concepts, your data object support schema must also specify the following:

  • How to enumerate objects of specified type, which is does by specifying a handler that is called when enumerating object is required.

  • How to retrieve metadata object metadata, such as object identifier or object properties.

  • How to construct a clipboard object in cases where a copy operation is performed on an object of the specified type. Visual Studio data designers use the Data Source Reference (DSRef) clipboard format. Objects that support DSRef can be dragged-and-dropped onto Visual Studio data designers.

For more information about data object support, see DDEX Data Object Support.

Data View Support

Using a data view support XML file, a DDEX provider defines the physical hierarchy of data objects displayed under a given connection node in the Visual Studio Server Explorer. You can define multiple views for the same data source.

In addition to defining the physical object hierarchy, you can also specify additional information about hierarchy nodes, including such things as localized display name, context menu commands (command name, CLSID, and handler), icons, and other information, as needed.

Access Services

DDEX provides a set of managed classes that Visual Studio calls to access functionality implemented by the DDEX provider in the form of support entities. These classes are known collectively as the DDEX access services.

Some of the more important access services include the following:

  • Provider Manager allows you to enumerate registered DDEX providers and query for objects of a specific type (DataProviderManager class).

  • Data Provider Object Factory provides a way to create data objects implemented by the DDEX provider (DataProviderObjectFactory class).

  • Data Connection Factory allows you to create connection objects (DataConnectionFactory class).

  • Data Connection Dialog allows you to prompt the user for connection information and create connection objects (DataConnectionDialog class).

DDEX access services allow Visual Studio to communicate with data sources in a design-time context. This requires having components that service a connection to the data source as well as having a set of specialized services that provide access to data source object types and views of their hierarchical layouts.

In a typical implementation, a DDEX client calls on the data provider object factory to instantiate the key building blocks. These key building blocks include the connection-building and connection support objects (see Mappings illustration). Some of these building-block objects then generate secondary objects, as needed, on down the support entities hierarchy. For example, the connection support object proffers a set of connection-specific services, such as a data view support object, which in turn provides XML file support by providing data view command handler and data view browse object provider objects, as required.

Picture a typical implementation using the Mappings illustration by starting at the top of the Support Entities side and working its way down the diagram. The factory class provides a hierarchy-like array of functional elements which the provider implements as needed. While the data provider implements the Support Entities in this way, each element of the implementation maps to a corresponding element on the Access Services side, which clients are consuming on behalf of Visual Studio.

You can view the data source connection (and its key pieces, such as the connection manager and connection factory) as an integrated service proffered by the data extensibility framework. In this view, the Visual Studio metadata engine acts like a connection client, consuming Access Services APIs, which in turn call into their corresponding support entities. This is the mechanism through which Visual Studio assembles a support structure to service the connection to the data source.

The central difference between support entities and access services is that extensibility clients consume the access services (primarily the connection object), which in turn talk to the DDEX provider. Viewed from the opposite direction, providers interact with the connection using the support entities APIs.

Under some circumstances, the roles of the access services and the support entities overlap, particularly where it is necessary to ensure thread safety. The DDEX architecture provides a secure locking layer between the data provider and the connection client for this purpose. The following example illustrates the feature.

When you call, for example, the DataCommand class from the connection object, rather than obtaining a data command object, the connection object instead gets a proxy implementation of the DataCommand class. The proxy implementation talks to the support entity that implements it; additionally, the proxy implementation is thread-safe. In this way, the proxy first locks the connection and then calls down into the support entities; when finished with the connection, it again unlocks the connection, releasing a thread lock.

In this example, the DataCommand class is implemented as an access service (in that the client calls it directly), but also behaves as a support entity, in that the data provider implements the same class, and that the outcome is the creation of a secure locking layer between the provider and the connection client.

The table below lists APIs regarded as Access Services and Support Entities.

Access Services APIs Support Entities APIs

DataAsyncCommand (Connection Service)

DataAsyncCommandEvents

DataCommand (Connection Service)

DataConnection

DataConnectionDialog

DataConnectionDialogFactory (Global Service)

DataConnectionFactory (Global Service)

DataConnectionManager (Global Service)

DataExplorerConnection

DataExplorerConnectionManager(Global Service)

DataConnectionOpenCanceledException

DataConnectionProperties

DataObjectChangeEvents

DataObjectIdentifierConverter (Connection Service)

DataObjectIdentifierResolver (Connection Service)

DataParameter

DataProtection

DataProvider

DataProviderException

DataProviderManager (Global Service)

DataReader

DataSourceInformation (Connection Service)

DataSource

DataSourceManager(Global Service)

DataSourceVersionComparer (Connection Service)

DataTransaction (Connection Service)

DataViewManager (Global Service)

DataAsyncCommandRequest(enum)

DataCommandType (enum)

DataConnectionState (enum)

DataItemTypeFormat (enum)

DataObjectIdentifierFormat (enum)

DataParameterDirection (enum)

DataAsyncCommand (Connection Service)

DSRefBuilder

DataCommand (Connection Service)

DataConnectionPromptDialog

DataConnectionProperties

DataConnectionSupport

DataConnectionUIControl

DataObjectConceptMapper

DataObjectEnumerator

DataObjectIdentifierConverter (Connection Service)

DataObjectIdentifierResolver (Connection Service)

DataObjectItemComparer(Connection Service)

DataObjectRestrictionMapper

DataParameter

DataProviderObjectFactory (Global Service)

DataReader

DataSourceInformation (Connection Service)

DataSourceSpecializer

DataSourceVersionComparer (Connection Service)

DataTransaction (Connection Service)

DataViewBrowseObjectProvider

DataViewCommandHandler

DataObjectSupport (Connection Service)

DataViewSupport (Connection Service)

DDEX Reference

The DDEX SDK provides complete language reference documentation:

Data Object Support XML Schema

Use the data object support schema (VsDataObjectSupport.xsd) to programmatically manage and enumerate instances of data-source objects. For more information about data objects, see DDEX Data Object Support.

Data View Support XML Schema

Use the data view support schema (VsDataViewSupport.xsd) to manage one or more views of your data object hierarchy layout as it appears in the Server Explorer window. For more information about data views, see DDEX Data View Support.

Managed Class Library Reference

The DDEX SDK provides a set of managed base classes that allow you to write a managed DDEX provider. For more information about the library of managed base classes, see DDEX Managed Class Library Reference.

See Also

Community Additions

ADD
Show:
© 2014 Microsoft