CogoPointCollectionImportPoints(String, PointFileFormat, Boolean, Boolean, Boolean, ObjectId) Method

Imports points from a point file to an existing PointGroup with advanced options.

Namespace: Autodesk.Civil.DatabaseServices
Assembly: AeccDbMgd (in AeccDbMgd.dll) Version: 13.8.0.292
Syntax
Copy
public static uint ImportPoints(
	string pointFileFullName,
	PointFileFormat fileFormat,
	bool useAdjustedElevation,
	bool shouldTransformCoordinate,
	bool shouldExpandCoordinateData,
	ObjectId pointGroupId
)

Parameters

pointFileFullName  String
The full path and name of the point file.
fileFormat  PointFileFormat
The file format for the point file. You can get a collection of supported point file formats by using GetPointFileFormats.
useAdjustedElevation  Boolean
Specifies whether to adjust the point elevation values.
shouldTransformCoordinate  Boolean
Specifies whether to transform the points in the file.
shouldExpandCoordinateData  Boolean
Specifies whether to calculate the coordinate data properties of the points, such as degrees, minutes, seconds, and hemisphere for latitude and longitude.
pointGroupId  ObjectId
The ObjectId of the PointGroup into which the CogoPoints are imported.

Return Value

UInt32
The count of CogoPoints that were imported.
Exceptions
ExceptionCondition
ArgumentException Thrown when:
  1. The pointFileFullName does not exist.
  2. The point file content doesn't match the specified point file format.
  3. The PointGroupId is invalid.
Remarks
  1. useAdjustedElevation and shouldExpandCoordinateData are disregarded if they are not supported by the specified point file format.
  2. Set the pointGroupId to ObjectId::Null to specify that the imported points are not added to a PointGroup.
Example
Copy
 1// This point file is included as a sample for Civil 3D tutorials:
 2string pointFilePath = @"C:\Program Files\Autodesk\AutoCAD Civil 3D 2013\Help\Civil Tutorials\";
 3string pointFileName = pointFilePath + "Existing Ground Points - PENZD.txt";
 4string pointFileFormatName = "PENZD (space delimited)";
 5PointFileFormat pointFileFormat = PointFileFormatCollection.GetPointFileFormats(_acaddoc.Database)[pointFileFormatName];
 6ObjectId pointGroupId = _civildoc.PointGroups.Add("Example Point Group");
 7bool useAdjustedElevation = true;
 8bool shouldTransformCoordinate = true;
 9bool shouldExpandCoordinateData = true;
10
11uint result = CogoPointCollection.ImportPoints(pointFileName, pointFileFormat,
12    useAdjustedElevation, shouldTransformCoordinate, shouldExpandCoordinateData, pointGroupId);
13write("Successfully imported " + result + " points\n");
See Also