Imports points from a point file with advanced options.

Namespace: Autodesk.Civil.DatabaseServices
Assembly: AeccDbMgd (in AeccDbMgd.dll) Version: 10.3.488.0

Syntax

C#
public static uint ImportPoints(
	string pointFileFullName,
	PointFileFormat fileFormat,
	bool useAdjustedElevation,
	bool shouldTransformCoordinate,
	bool shouldExpandCoordinateData
)
Visual Basic
Public Shared Function ImportPoints ( _
	pointFileFullName As String, _
	fileFormat As PointFileFormat, _
	useAdjustedElevation As Boolean, _
	shouldTransformCoordinate As Boolean, _
	shouldExpandCoordinateData As Boolean _
) As UInteger
Visual C++
public:
static unsigned int ImportPoints(
	String^ pointFileFullName, 
	PointFileFormat^ fileFormat, 
	bool useAdjustedElevation, 
	bool shouldTransformCoordinate, 
	bool shouldExpandCoordinateData
)

Parameters

pointFileFullName
Type: System..::..String
The full path and name of the point file.
fileFormat
Type: Autodesk.Civil.DatabaseServices..::..PointFileFormat
The file format for the point file. You can get a collection of supported point file formats by using GetPointFileFormats()()()().
useAdjustedElevation
Type: System..::..Boolean
Specifies whether to adjust the point elevation values.
shouldTransformCoordinate
Type: System..::..Boolean
Specifies whether to transform the points in the file.
shouldExpandCoordinateData
Type: System..::..Boolean
Specifies whether to calculate the coordinate data properties of the points, such as degrees, minutes, seconds, and hemisphere for latitude and longitude.

Return Value

The count of CogoPoints that were imported.

Remarks

useAdjustedElevation and shouldExpandCoordinateData are disregarded if they are not supported by the specified point file format.

Examples

CopyC#
 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];
 6bool useAdjustedElevation = true;
 7bool shouldTransformCoordinate = true;
 8bool shouldExpandCoordinateData = true;
 9
10uint result = CogoPointCollection.ImportPoints(pointFileName, pointFileFormat, 
11    useAdjustedElevation, shouldTransformCoordinate, shouldExpandCoordinateData);
12write("Successfully imported " + result + " points\n");
CopyVB.NET
 1' This point file is included as a sample for Civil 3D tutorials:
 2Dim pointFilePath As String = "C:\Program Files\Autodesk\AutoCAD Civil 3D 2013\Help\Civil Tutorials\"
 3Dim pointFileName As String = pointFilePath & "Existing Ground Points - PENZD.txt"
 4Dim pointFileFormatName As String = "PENZD (space delimited)"
 5Dim pointFileFormat As PointFileFormat = PointFileFormatCollection.GetPointFileFormats(_acaddoc.Database)(pointFileFormatName)
 6Dim useAdjustedElevation As Boolean = True
 7Dim shouldTransformCoordinate As Boolean = True
 8Dim shouldExpandCoordinateData As Boolean = True
 9
10Dim result As UInteger = CogoPointCollection.ImportPoints(pointFileName, pointFileFormat, useAdjustedElevation, shouldTransformCoordinate, shouldExpandCoordinateData)
11write("Successfully imported " & result & " points" & vbLf)

Exceptions

ExceptionCondition
System..::..ArgumentException Thrown when:
  1. The pointFileFullName does not exist.
  2. The point file content doesn't match the specified point file format.

See Also