Imports points from a point file to an existing PointGroup.

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

Syntax

C#
public static uint ImportPoints(
	string pointFileFullName,
	PointFileFormat fileFormat,
	ObjectId pointGroupId
)
Visual Basic
Public Shared Function ImportPoints ( _
	pointFileFullName As String, _
	fileFormat As PointFileFormat, _
	pointGroupId As ObjectId _
) As UInteger
Visual C++
public:
static unsigned int ImportPoints(
	String^ pointFileFullName, 
	PointFileFormat^ fileFormat, 
	ObjectId pointGroupId
)

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()()()().
pointGroupId
Type: ObjectId
The ObjectId of the PointGroup into which the CogoPoints are imported.

Return Value

The count of CogoPoints that were imported.

Remarks

Set the pointGroupId to ObjectId::Null to specify that the imported points are not added to a PointGroup.

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];
6ObjectId pointGroupId = _civildoc.PointGroups.Add("Example Point Group");
7
8uint result = CogoPointCollection.ImportPoints(pointFileName, pointFileFormat, pointGroupId);
9write("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 pointGroupId As ObjectId = _civildoc.PointGroups.Add("Example Point Group")
7
8Dim result As UInteger = CogoPointCollection.ImportPoints(pointFileName, pointFileFormat, pointGroupId)
9write("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.
  3. The PointGroupId is invalid.

See Also