ImportPoints Method (String, PointFileFormat, ObjectId)

Imports points from a point file to an existing PointGroup.

Namespace: Autodesk.Civil.DatabaseServices
Assembly: AeccDbMgd (in AeccDbMgd.dll) Version: 13.3.1717.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

Exception	Condition
System.ArgumentException	Thrown when: The pointFileFullName does not exist. The point file content doesn't match the specified point file format. The PointGroupId is invalid.