DSRefBuilder.BuildDSRef Method

Article
04/22/2008

Builds a DSRef object that identifies a data object with the specified type and identifier.

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

Syntax

Public Function BuildDSRef ( _
    typeName As String, _
    identifier As Object(), _
    parameters As Object() _
) As Object

Dim instance As DSRefBuilder
Dim typeName As String
Dim identifier As Object()
Dim parameters As Object()
Dim returnValue As Object

returnValue = instance.BuildDSRef(typeName, _
    identifier, parameters)

public Object BuildDSRef(
    string typeName,
    Object[] identifier,
    Object[] parameters
)

public:
Object^ BuildDSRef(
    String^ typeName, 
    array<Object^>^ identifier, 
    array<Object^>^ parameters
)

public function BuildDSRef(
    typeName : String, 
    identifier : Object[], 
    parameters : Object[]
) : Object

Parameters

typeName
Type: System.String

The name of the type of object.

identifier
Type: array<System.Object[]

The identifier of the object.

parameters
Type: array<System.Object[]

An array whose contents are defined by the particular implementation of BuildDSRef method and specified by the Data Object Support XML. Such information can be used to provide extra data indicating how to build the DSRef object. This allows an implementation of BuildDSRef to be more data driven.

Return Value

Type: System.Object

Returns a DSRef object that identifies a specified data object.

Exceptions

Exception	Condition
ArgumentNullException	The typeName and/or identifier parameters are null.
ArgumentException	The parameters argument is in an invalid format.
ExternalException	Could not create DSRef object.

Remarks

The base implementation of this method will create a DSRef object and delegate to AppendToDSRef.

Permissions

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Share via