Function ReplaceComponents2( _
   ByVal FileName As System.String, _
   ByVal ConfigName As System.String, _
   ByVal ReplaceAllInstance As System.Boolean, _
   ByVal UseConfigChoice As System.Integer, _
   ByVal ReAttachMates As System.Boolean _
) As System.Boolean

Dim instance As IAssemblyDoc
Dim FileName As System.String
Dim ConfigName As System.String
Dim ReplaceAllInstance As System.Boolean
Dim UseConfigChoice As System.Integer
Dim ReAttachMates As System.Boolean
Dim value As System.Boolean
 
value = instance.ReplaceComponents2(FileName, ConfigName, ReplaceAllInstance, UseConfigChoice, ReAttachMates)

System.bool ReplaceComponents2( 
   System.string FileName,
   System.string ConfigName,
   System.bool ReplaceAllInstance,
   System.int UseConfigChoice,
   System.bool ReAttachMates
)

System.bool ReplaceComponents2( 
&   System.String^ FileName,
&   System.String^ ConfigName,
&   System.bool ReplaceAllInstance,
&   System.int UseConfigChoice,
&   System.bool ReAttachMates
) 

Parameters

FileName

Path and file name of the replacement component

ConfigName

Name of a configuration in the replacement component; an emtpy string indicates the default configuration of the replacement component

ReplaceAllInstance

True to replace all instances of the selected components with the replacement component, false to not

UseConfigChoice

Configuration to use as defined in swReplaceComponentsConfiguration_e

ReAttachMates

True to reattach existing mates to the replacement component, false to not

Return Value

You cannot replace a selected component with a component of the same name even if the components reside in different folders.

The component must be a top-level component. It cannot be a component of a sub-assembly. If your application needs to replace a component of a sub-assembly, then your application must open the sub-assembly and get the component from that assembly.

This method closes any component files when called in an assembly. If components were modified, then those modifications are not automatically saved. You must save any modifications before closing the files.