RealtimeDatastore Constructor

In This Topic

Opens a real-time datastore with a RealtimeServiceConnectionProperties. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

C#
Visual Basic (Declaration)

public RealtimeDatastore( 
   RealtimeServiceConnectionProperties connectionProperties
)

Public Function New( _
   ByVal connectionProperties As RealtimeServiceConnectionProperties _
)

Parameters

connectionProperties: A valid RealtimeServiceConnectionProperties object which has the URI to a real-time service such as stream service. In case the service is not a public, the username and password properties are also expected to be set.

Exceptions

Exception	Description
ArcGIS.Core.Data.Exceptions.GeodatabaseNotFoundOrOpenedException	The information used to connect to the a real-time service is invalid.
System.ArgumentException	The URL is not provided.
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.
System.ArgumentNullException	connectionProperties
ArcGIS.Core.Data.Exceptions.GeodatabaseNotFoundOrOpenedException	Represents a geodatabase not found or not opened exception.

Example

Connect to a real-time feature class from a real-time datastore

var url = "https://geoeventsample1.esri.com:6443/arcgis/rest/services/AirportTraffics/StreamServer";
     
await QueuedTask.Run(() =>
{
  var realtimeServiceConProp = new RealtimeServiceConnectionProperties(
                                   new Uri(url),
                                   RealtimeDatastoreType.StreamService
                                );
  using (var realtimeDatastore = new RealtimeDatastore(realtimeServiceConProp))
  {
    //A Realtime data store only contains **one** Realtime feature class (or table)
    var name = realtimeDatastore.GetTableNames().First();
    using (var realtimeFeatureClass = realtimeDatastore.OpenTable(name) as RealtimeFeatureClass)
    {
      //feature class, by default, is not streaming (opposite of the stream layer)
      realtimeFeatureClass.StartStreaming();
      //TODO use the feature class
      //...
    }
  }

});

Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3 or higher.

Reference

RealtimeDatastore Class
RealtimeDatastore Members

Send feedback