Document.Export(String, String, ICollection.ElementId., DGNExportOptions)

Public Class

Exports a selection of views in DGN format.

Assembly: RevitAPI (in RevitAPI.dll) Version: 25.0.0.0 (25.0.0.0)

Syntax

public bool Export(
  string folder,
  string name,
  ICollection<ElementId> views,
  DGNExportOptions options
)

Parameters

folderString

Output folder, into which file(s) will be exported. The folder must exist.

nameString

Either the name of a single file or a prefix for a set of files. If empty, automatic naming will be used. If ., throw ArgumentException.

viewsICollection. ElementId.

Selection of views to be exported. The set must contain at least one valid view.

options DGNExportOptions

Various options applicable to the DGN format. If ., all options will be set to their respective default values.

Return Value

Boolean
True if successful, otherwise False.

Exceptions

Exception

Condition

ArgumentException

NullOrEmpty -or- Contains invalid characters. -or- non empty list of views must be provided. -or- some of the views are not printable (exportable). -or- Thrown when the options in DGNExportOptions is invalid.

ArgumentNullException

A non-optional argument was null

DirectoryNotFoundException

Thrown when the directory does not exist.

InvalidOperationException

Export is temporarily disabled. -or- Exporting is not allowed in the current application mode.

InvalidPathArgumentException

The folder does not exist.

OptionalFunctionalityNotAvailableException

The DWG module is not available in the installed Revit. -or- The Graphics module is not available in the installed Revit.

Remarks

All the views must be printable for the Export to succeed. It can be assured by checking the CanBePrinted property of each view.

Example

public bool ExportDGN(Document document, View view)
{
    bool exported = false;
    // Get predefined setups and use the first one
    IList<string> setupNames = BaseExportOptions.GetPredefinedSetupNames(document);
    if (setupNames.Count > 0)
    {
        // Get predefined options for first predefined setup
        DGNExportOptions dgnOptions = DGNExportOptions.GetPredefinedOptions(document, setupNames[0]);

        // export the active view if it is printable
        if (view.CanBePrinted == true)
        {
            ICollection<ElementId> views = new List<ElementId>();
            views.Add(view.Id);
            exported = document.Export(Path.GetDirectoryName(document.PathName),
                Path.GetFileNameWithoutExtension(document.PathName), views, dgnOptions);
        }
    }

    return exported;
}