DacStore Class

The root class of the DAC Domain. The Main role of this class is to store the connection and interact with the SFC framework for most of the services.

Inheritance Hierarchy

System.Object
  Microsoft.SqlServer.Management.Sdk.Sfc.SfcInstance
    Microsoft.SqlServer.Management.Dac.DacDomain
      Microsoft.SqlServer.Management.Dac.DacStore

Namespace:  Microsoft.SqlServer.Management.Dac
Assembly:  Microsoft.SqlServer.Management.Dac (in Microsoft.SqlServer.Management.Dac.dll)

Syntax

'Declaration
Public Class DacStore _
    Inherits DacDomain
'Usage
Dim instance As DacStore

public class DacStore : DacDomain

public ref class DacStore : public DacDomain

type DacStore =  
    class
        inherit DacDomain
    end

public class DacStore extends DacDomain

The DacStore type exposes the following members.

Constructors

	Name	Description
	DacStore	Initializes a new instance of the DacStore class connected to the specified instance of the Database Engine.

Top

Properties

	Name	Description
	AbstractIdentityKey	Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
	DacInstances	Gets a DacInstanceCollection object that enumerates the DAC instances deployed or registered on an instance of the Database Engine. (Inherited from DacDomain.)
	DacStore	Gets the DacStore object associated with this DacDomain object. (Inherited from DacDomain.)
	Metadata	Returns metadata about the instance and its domain. (Inherited from SfcInstance.)
	Name	Gets a String value with the name of the instance of the Database Engine to which the DAC domain is connected. (Inherited from DacDomain.)
	Parent	Gets or sets the instance parent via the keychain. (Inherited from SfcInstance.)
	Properties	Returns a collection instance properties. (Inherited from SfcInstance.)
	PropertyStorageProvider	Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
	ServerConnection	Gets server connection information.
	SqlStoreConnection	Gets or sets the connection to the instance of SQL Server. (Overrides DacDomain.SqlStoreConnection.)
	State	Returns the state of the SfcInstance object. (Inherited from SfcInstance.)
	Urn	Returns the uniform resource name of the SfcInstance object. (Inherited from SfcInstance.)

Top

Methods

	Name	Description
	AlterImpl	Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
	CheckObjectCreated	Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
	CheckObjectState	Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
	CreateIdentityKey	Creates a SfcKey object for the DAC domain. (Inherited from DacDomain.)
	CreateImpl	Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
	Discover	Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
	DropImpl	Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
	Equals	(Inherited from Object.)
	Export(String, Stream)	Exports a DAC object with specified database name and stream.
	Export(String, String)	Exports a DAC object with specified database name and path.
	Export(String, Stream, IEnumerable<TableName>)	Exports a DAC object with specified database name, stream, and tables.
	Finalize	(Inherited from Object.)
	GetChildCollection	Identified for informational purposes only. Not supported. Future compatibility is not guaranteed. Returns a ISfcCollection object. (Inherited from DacDomain.)
	GetDatabaseChanges	Gets the changes made to the specified database.
	GetDomain	Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
	GetHashCode	(Inherited from Object.)
	GetIncrementalUpgradeScript	Gets the script used in the DAC incremental upgrade.
	GetPropertySet	Returns the set of properties for the SfcInstance object. (Inherited from SfcInstance.)
	GetType	(Inherited from Object.)
	GetTypeMetadataImpl	Indicates the domains that override by returning the right TypeMetadata class directly. Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
	Import(Stream)	Imports a DAC object with specified stream.
	Import(Stream, DatabaseDeploymentProperties, Boolean)	Imports a DAC object with specified stream, deployment properties, and validation.
	Import(String, DatabaseDeploymentProperties, Boolean)	Imports a DAC object with specified deployment properties, path, and validation.
	IncrementalUpgrade	Displays the DAC incremental upgrade.
	InitializeUIPropertyState	Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
	Install(DacType)	Uses the specified DacType object to create a DAC instance in the instance of the Database Engine represented by the DacStore object.
	Install(DacType, DatabaseDeploymentProperties, Boolean)	Uses the specified DacType object to create a DAC instance in the instance of the Database Engine represented by the DacStore object.
	MarkForDropImpl	Returns a value that indicates the existing objects to be dropped. Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
	MarkRootAsConnected	Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
	MemberwiseClone	(Inherited from Object.)
	MoveImpl	Indicates the new parent object to move in an instance. Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
	OnPropertyMetadataChanges	Invoked whenever the effective value of any SfcInstance metadata is updated. (Inherited from SfcInstance.)
	OnPropertyValueChanges	Invoked whenever the effective value of any SfcInstance property is updated. (Inherited from SfcInstance.)
	PostAlter	Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
	PostCreate	Indicates the default implementor that creates the execution result. Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
	PostDrop	Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
	PostMove	Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
	PostRename	Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
	Refresh	Refreshes the object's properties by reading them from the server. (Inherited from SfcInstance.)
	RenameImpl	Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
	ResetKey	Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
	Serialize	Serializes the instance to XML. (Inherited from SfcInstance.)
	ToString	Returns a string representation of the instance Urn. (Inherited from SfcInstance.)
	Uninstall	Deletes the specified DAC instance from the instance of the Database Engine associated with the DacStore.
	Unmanage	Deletes the a DAC instance without affecting the database associated with the instance.
	UpdateUIPropertyState	Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
	Validate	Indicates the basic child object's validation. Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)

Top

Events

	Name	Description
	DacActionFinished	Returns events as they are completed from the DacStore Install(), Uninstall(), and Upgrade() methods.
	DacActionInitialized	Returns events as they are initialized to pending status from the DacStore Install(), Uninstall(), and Upgrade() methods.
	DacActionStarted	Returns events as they start running for the DacStore Install(), Uninstall(), and Upgrade() methods.
	propertyChanged	Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
	PropertyChanged	CLS-compliant event for property changes. (Inherited from SfcInstance.)
	propertyMetadataChanged	Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
	PropertyMetadataChanged	CLS-compliant event for property metadata changes. (Inherited from SfcInstance.)

Top

Explicit Interface Implementations

	Name	Description
	ISfcDomain.GetExecutionEngine	Returns an ISfcExecutionEngine object that specifies an instance of the Database Engine for running scripts. (Inherited from DacDomain.)
	ISfcDomain.GetKey	Gets a SfcKey object that represents the DAC domain. (Inherited from DacDomain.)
	ISfcDomain.GetType	Gets a Type object describing the Sfc type with the specified name within the Sfc domain. (Inherited from DacDomain.)
	ISfcDomain.GetTypeMetadata	Obsolete. Gets the metadata for the specified SFC type. (Inherited from DacDomain.)
	ISfcDomain.UseSfcStateManagement	Specifies whether to use the state management provided by the Microsoft.SqlServer.Management.Sdk.Sfc namespace. (Inherited from DacDomain.)
	ISfcDomainLite.DomainInstanceName	Gets the specified instance name of the domain. (Inherited from DacDomain.)
	ISfcDomainLite.DomainName	Gets the specified name of the domain. (Inherited from DacDomain.)
	ISfcDomainLite.GetLogicalVersion	Gets a logical version number that represents the level of changes to the object model in the SFC domain. (Inherited from DacDomain.)
	ISfcHasConnection.ConnectionContext	Gets the specified context for the connection. (Inherited from DacDomain.)
	ISfcHasConnection.GetConnection()	Gets a connection to the instance of the Database Engine serving as a backing store. (Inherited from DacDomain.)
	ISfcHasConnection.GetConnection(SfcObjectQueryMode)	Gets a connection to the instance of the Database Engine serving as a backing store that supports the specified query processing mode. (Inherited from DacDomain.)
	ISfcHasConnection.SetConnection	Sets the active connection for the domain root. (Inherited from DacDomain.)

Top

Remarks

Using the DacStore object, you can:

• Connect to an instance of the Database Engine.

• Access the collection of DacInstance objects that are immediate children of the DacStore object. The collection represents the set of DAC instances available on the instance of the Database Engine.

• Request create, read, update, and delete (CRUD) operations for every type in the object model.

Note

The DacStore class implements ISfcDomain, which specifies the connection point to any object domain defined using the Microsoft.SqlServer.Management.Sdk.Sfc namespace.

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.SqlServer.Management.Dac Namespace