Replaces the group with the contents of the input file.
Namespace: Autodesk.Revit.DB
Assembly: RevitAPI (in RevitAPI.dll) Version: 24.0.0.0 (24.0.0.0)
Since: 2024
Syntax
| C# |
|---|
|
| Visual Basic |
|---|
|
| Visual C++ |
|---|
|
Parameters
- fileName
- Type: SystemString
The file to be used for the replacment.
- options
- Type: Autodesk.Revit.DBGroupLoadOptions
Group load options.
Examples
CopyC#public void LoadGroup(Group group, string filePath)
{
GroupLoadOptions options = new GroupLoadOptions();
options.ReplaceDuplicatedGroups = true;
options.SetDuplicateTypeNamesHandler(new CustomDuplicateTypeNamesHandler());
group.GroupType.LoadFrom(filePath, options);
}
class CustomDuplicateTypeNamesHandler : IDuplicateTypeNamesHandler
{
public DuplicateTypeAction OnDuplicateTypeNamesFound(DuplicateTypeNamesHandlerArgs args)
{
return DuplicateTypeAction.UseDestinationTypes;
}
}Exceptions
| Exception | Condition |
|---|---|
| Autodesk.Revit.ExceptionsArgumentException | Not a valid RVT file. |
| Autodesk.Revit.ExceptionsArgumentNullException | A non-optional argument was null |
| Autodesk.Revit.ExceptionsFileArgumentNotFoundException | The given fileName does not exist. |
| Autodesk.Revit.ExceptionsInvalidOperationException | The element "this GroupType" is in a document which is in an edit mode or is in family mode. -or- The element "this GroupType" does not belong to a project document. -or- The GroupType is not a Model group type and can't be reloaded. |
| Autodesk.Revit.ExceptionsModificationForbiddenException | The document containing this GroupType is in failure mode: an operation has failed, and Revit requires the user to either cancel the operation or fix the problem (usually by deleting certain elements). -or- The document containing this GroupType is being loaded, or is in the midst of another sensitive process. |
| Autodesk.Revit.ExceptionsModificationOutsideTransactionException | The document containing this GroupType has no open transaction. |