A Sandcastle Documented Class Library

# IDataConnectorService DiscoverSpecifiedStructures Method (Guid, SupportedDataStructures, ICollection String , Boolean)

Discovers names and descriptions of the native data structures and saves them into the application database. Only structures in structureNamesToDiscover will be discovered. This method also discovers relationships between tables.

Namespace: Dundas.BI.Entities.DataConnectors
Assembly: Dundas.BI.Core (in Dundas.BI.Core.dll) Version: 2.0.0.0 (10.0.0.1002)
Syntax
C#
VB
C++
F#
Copy

    void DiscoverSpecifiedStructures(
    	Guid dataConnectorId,
    	SupportedDataStructures types,
    	ICollection<string> structureNamesToDiscover,
    	bool deleteUnusedStructures
    )

    Sub DiscoverSpecifiedStructures (
    	dataConnectorId As Guid,
    	types As SupportedDataStructures,
    	structureNamesToDiscover As ICollection(Of String),
    	deleteUnusedStructures As Boolean
    )

    void DiscoverSpecifiedStructures(
    	Guid dataConnectorId,
    	SupportedDataStructures types,
    	ICollection<String^>^ structureNamesToDiscover,
    	bool deleteUnusedStructures
    )

    abstract DiscoverSpecifiedStructures :
            dataConnectorId : Guid *
            types : SupportedDataStructures *
            structureNamesToDiscover : ICollection<string> *
            deleteUnusedStructures : bool -> unit

#### Parameters

dataConnectorId
  Type: System
  Guid
  The data connector ID.
types
  Type: Dundas.BI.Data.Metadata
  SupportedDataStructures
  Structure types to discover.
structureNamesToDiscover
  Type: System.Collections.Generic
  ICollection
  String
  The structure names to discover.
deleteUnusedStructures
  Type: System
  Boolean
  If set to
  , delete unused structures.

Exceptions

Exception | Condition
--- | ---
ArgumentException | dataConnectorId is Empty.
NotFoundException | The data connector with the specified ID does not exist.
NoPrivilegeException | Caller does not have the Read privilege on the specified data connector.
DataProviderLoadException | The data provider requires third party driver to be installed.
DataConnectionException | The connection cannot be established.
InvalidSessionException | The caller context is not associated with a valid session.

Remarks
If the structures already exist (were previously discovered), this method will do the following: - new structures : add; - existing structures : update; - structures no longer there : delete, if deleteUnusedStructures is
.
See Also

#### Reference

IDataConnectorService Interface
DiscoverSpecifiedStructures Overload
Dundas.BI.Entities.DataConnectors Namespace