Share via


DataObjectIdentifierConverter Class

Provides the ability to convert data source–specific object identifiers from strings to identifier parts, and from identifier parts to strings.

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

Syntax

'Declaration
Public MustInherit Class DataObjectIdentifierConverter _
    Inherits DataSiteableObject(Of IVsDataConnection) _
    Implements IVsDataObjectIdentifierConverter
'Usage
Dim instance As DataObjectIdentifierConverter
public abstract class DataObjectIdentifierConverter : DataSiteableObject<IVsDataConnection>, 
    IVsDataObjectIdentifierConverter
public ref class DataObjectIdentifierConverter abstract : public DataSiteableObject<IVsDataConnection^>, 
    IVsDataObjectIdentifierConverter
public abstract class DataObjectIdentifierConverter extends DataSiteableObject<IVsDataConnection> implements IVsDataObjectIdentifierConverter

Remarks

Typically, the identifier of an object on a data source consists of a string that is used in commands that get executed. For example, in the SQL statement SELECT * FROM mytable, the string mytable is the unique identifier of an object in the context under which the statement is running.

Typically a data source has some kind of containment mechanism for objects, such as a catalog, schema, or package. This introduces the need for multiple-part identifiers because a single name no longer suffices for uniquely identifying objects. For example, an Oracle server groups different objects under different users, causing the unique identifier of an object to be qualified with a user name.

Because the format of such multiple-part identifiers can vary from one data source to another, there has to be a way to convert a given string into its set of parts and vice versa. This class provides such a mechanism.

Inheritance Hierarchy

System.Object
  Microsoft.VisualStudio.Data.Framework.DataSiteableObject<IVsDataConnection>
    Microsoft.VisualStudio.Data.Framework.DataObjectIdentifierConverter
      Microsoft.VisualStudio.Data.Framework.AdoDotNet.AdoDotNetObjectIdentifierConverter

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

DataObjectIdentifierConverter Members

Microsoft.VisualStudio.Data.Framework Namespace

DataObjectIdentifierResolver