AdoDotNetProviderObjectFactory Class

Provides an implementation of the DataProviderObjectFactory class for DDEX Providers whose underlying technology is ADO.NET.

Inheritance Hierarchy

System.Object
  Microsoft.VisualStudio.Data.ObjectWithSite
    Microsoft.VisualStudio.Data.DataProviderObjectFactory
      Microsoft.VisualStudio.Data.AdoDotNet.AdoDotNetProviderObjectFactory

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

Syntax

'Declaration
Public Class AdoDotNetProviderObjectFactory _
    Inherits DataProviderObjectFactory

public class AdoDotNetProviderObjectFactory : DataProviderObjectFactory

public ref class AdoDotNetProviderObjectFactory : public DataProviderObjectFactory

type AdoDotNetProviderObjectFactory =  
    class 
        inherit DataProviderObjectFactory 
    end

public class AdoDotNetProviderObjectFactory extends DataProviderObjectFactory

The AdoDotNetProviderObjectFactory type exposes the following members.

Constructors

	Name	Description
	AdoDotNetProviderObjectFactory	Class constructor. Instantiates a new instance of the AdoDotNetProviderObjectFactory class.

Top

Properties

	Name	Description
	DataProvider	Retrieves the DDEX provider for which this class creates objects. (Inherited from DataProviderObjectFactory.)
	Site	Retrieves or sets the object site. (Inherited from ObjectWithSite.)

Top

Methods

	Name	Description
	CreateObject	Supports creation of the DataConnectionProperties and DataConnectionSupport types. (Overrides DataProviderObjectFactory.CreateObject(Type).)
	Equals	Determines whether the specified object is equal to the current object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	GetAssembly	Locates an assembly given an assembly string. (Inherited from DataProviderObjectFactory.)
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetType()	Gets the Type of the current instance. (Inherited from Object.)
	GetType(String)	Retrieves a type definition given a type name. (Inherited from DataProviderObjectFactory.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	OnSiteChanged	Raises the SiteChanged event. (Inherited from ObjectWithSite.)
	ToString	Returns a string that represents the current object. (Inherited from Object.)

Top

Events

	Name	Description
	SiteChanged	Event that is raised when the Site property is changed. (Inherited from ObjectWithSite.)

Top

Explicit Interface Implementations

	Name	Description
	IObjectWithSite.GetSite	Retrieves the last site set using the IObjectWithSite.SetSite method. In cases where there is no known site, the object returns an exception. (Inherited from ObjectWithSite.)
	IObjectWithSite.SetSite	Provides the site's pointer to the site object. (Inherited from ObjectWithSite.)

Top

Remarks

ADO.NET already provides a number of the features required to support a DDEX Provider, so this class automatically provides certain default implementations for classes if not overridden by a provider.

The following classes are implemented automatically:

• DataConnectionProperties: ADO.NET has a generic mechanism for building connection properties. The AdoDotNetConnectionProperties class provides a base implementation for ADO.NET providers.

• DataConnectionSupport: All ADO.NET providers must implement enough connection support to implement this class. The AdoDotNetConnectionSupport class provides a base implementation for ADO.NET providers.

In addition to these base classes that that you can create directly using this factory object, the following classes are also implemented:

• DataObjectEnumerator: ADO.NET has a generic mechanism for enumerating data objects. Two implementations are provided - one to provide "root" information, and another to enumerate collections of data using the GetSchema API.

• DataSourceInformation: ADO.NET has a generic mechanism for providing data source information. The base class may, however, not always provide complete information.

• DataCommand: ADO.NET already has a generic mechanism for executing commands.

• DataParameter: ADO.NET has a generic mechanism for working with parameters; however, it is somewhat limited insofar as it is not aware of back-end-specific parameter types.

• DataTransaction: ADO.NET has a generic mechanism for beginning and ending transactions.

• DataReader: All ADO.NET providers have various ways of exposing data. The AdoDotNetDataReader class provides a complete implementation using the ADO.NET IDataReader interface. The AdoDotNetDataTableReader class provides a complete implementation of this interface using the ADO.NET DataTable object. More implementations may be added if needed.

• DataObjectConceptMapper: ADO.NET exposes a generic set of data types which this class uses to implement data type mappings to the various data type property concepts recognized by DDEX.

• DataObjectIdentifierConverter: ADO.NET exposes some information that can be used to produce a reasonable base implementation of this class. It may not work correctly in all scenarios.

• DataObjectItemComparer: ADO.NET exposes some information that can be used to produce a simple implementation of this class. It will only work for basic scenarios.

This class relies on there being a ProviderInvariantName property specified in the registry by the DDEX provider that tells the class what the ADO.NET invariant name of the provider is. This is passed down to the specific objects to ensure that the correct implementations of ADO.NET objects are created.

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.

See Also

Reference

Microsoft.VisualStudio.Data.AdoDotNet Namespace

DataProviderObjectFactory