Clone (Dimension Interface)
Note
This feature will be removed in the next version of Microsoft SQL Server. Do not use this feature in new development work, and modify applications that currently use this feature as soon as possible.
The Clone method of the Dimension interface copies the properties and levels of an existing object to a target object of the same class type.
Applies To: clsDatabaseDimension
Syntax
object.Clone(ByVal TargetObject As Dimension, [ByVal Options As CloneOptions = cloneMajorChildren])
Remarks
- object
The Dimension object whose properties and levels are to be copied.
- TargetObject
A previously created object of the same class type.
- Options
The options to tell the method to what extent the source object should be duplicated. If no value is specified, the cloneMajorChildren option is used.
Remarks
The following values for Options are valid for cloning a dimension.
| Clone option | Description |
|---|---|
cloneObjectProperties |
The values of the properties of the source dimension are copied to the target dimension |
cloneMinorChildren |
The values of the properties and levels contained in the source dimension are copied to the target dimension |
cloneMajorChildren |
For dimension objects, this is the same as cloneMinorChildren |
Example
The following example copies the properties and levels of dimension DimA to dimension DimB:
Dim dsoServer As New DSO.Server
Dim dsoDB As DSO.MDStore
Dim dsoDimA As DSO.Dimension
Dim dsoDimB As DSO.Dimension
' Connect to local Analysis server.
dsoServer.Connect "LocalHost"
' Open the FoodMart 2000 database.
Set dsoDB = dsoServer.MDStores("FoodMart 2000")
' Create a new dimension, named DimA, to be used
' as a source dimension from which to clone.
Set dsoDimA = dsoDB.Dimensions.AddNew("DimA")
dsoDimA.Description = "First dimension"
' Create the target dimension, named DimB, and
' give it a different description.
Set dsoDimB = dsoDB.Dimensions.AddNew("DimB")
dsoDimB.Description = "Second dimension"
' Now, clone the DimA dimension into DimB.
dsoDimA.Clone dsoDimB, cloneMajorChildren
' Print the description of the DimB dimension
' to the Debug window.
Debug.Print dsoDimB.Description