ArcObjects Library Reference  (NetworkAnalyst)    

NAServerRecordSet CoClass

A container for a RecordSet of network locations.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Network Analyst Extension.

Extended Error Information

Use the ISupportErrorInfo method InterfaceSupportsErrorInfo to determine if the object supports extended error information. If the object supports extended error info, VC++ developers should use the OLE/COM IErrorInfo interface to access the ErrorInfo object. Visual Basic developers should use the global error object Err to retrieve this extended error information.

Interfaces

Interfaces Description
INAServerLocations Provides access to objects that can be used to load network locations in NAServer.
INAServerRecordSet Provides access to a RecordSet containing network locations.
IPersist Defines the single method GetClassID, which is designed to supply the CLSID of an object that can be stored persistently in the system. IPersist is the base interface for three other interfaces: IPersistStorage, IPersistStream, and IPersistFile.
IPersistStream (esriSystem)
ISupportErrorInfo Indicates whether a specific interface can return Automation error objects.
IXMLSerialize (esriSystem) Provides access to members that XML serialize and deserialize an object to/from XML.
IXMLVersionSupport (esriSystem) Provides access to members that help in serializing an object to different namespaces (versions).

Remarks

The NAServerRecordSet object holds a RecordSet object representing network locations.

The NAServerRecordSet object can be passed into any of the properties of the NAServerSolverParams objects that expect an INAServerLocations interface pointer.  For example, Stops, Barriers, Facilities, or Incidents.

At a minimum, the RecordSet needs a shape field with a point geometry type.  You can also add additional fields that you wish to be used when loading the network locations.  For example, if you specify the network location fields "SourceID" (long), "SourceOID" (long), "PosAlong" (double), and "SideOfEdge" (long), the values in these fields will specify the network location rather than performing a spatial search to determine the network location.

Any other fields can be added to the RecordSet and may be used when loading network locations.  INAServerSolverParams.NAClassCandidateFieldMaps determines which properties map to NAClass fields.