CreateStandaloneTable(Uri,IStandaloneTableContainerEdit,Int32,String) Method

In This Topic

Creates a new StandaloneTable instance with the specified path to a dataset and adds it to a container such as a map. Optionally you can provide a name to override the default display name. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

C#
Visual Basic (Declaration)

public StandaloneTable CreateStandaloneTable( 
   Uri tableUri,
   IStandaloneTableContainerEdit container,
   int index,
   string tableName
)

Public Overloads Function CreateStandaloneTable( _
   ByVal tableUri As Uri, _
   ByVal container As IStandaloneTableContainerEdit, _
   Optional ByVal index As Integer, _
   Optional ByVal tableName As String _
) As StandaloneTable

Parameters

tableUri: An URI represents the path to a dataset
container: A map or group layer where the StandaloneTable will be added
index: The position of the StandaloneTable in the map or group layer. 0 represents the top most position.
tableName: System.String (optional) When not provided, the default display name gets used e.g. the dataset name or alias. (default value = "")

Return Value

StandaloneTable

Exceptions

Exception	Description
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.
System.ArgumentNullException	TableUri or container is null

Remarks

Some sample paths to:

A table in a FileGeodatabase	C:\Data\MyFileGDB.gdb\MyNonSpatialTable
A dbf file in a folder	\\Machine\SharedFolder\MyNonSpatial.dbf

Example

StandaloneTable st = StandaloneTableFactory.Instance.CreateStandaloneTable(new Uri(@"C:\Data\Census.gdb\MyNonSpatialTable"), MapView.Active.Map);

StandaloneTable st = StandaloneTableFactory.Instance.CreateStandaloneTable(new Uri(@"\\Machine\SharedFolder\MyNonSpatial.dbf"), MapView.Active.Map);

Create a StandaloneTable

//container can be a map or group layer
var container = MapView.Active.Map;
//var container =  MapView.Active.Map.GetLayersAsFlattenedList()
//                                  .OfType<GroupLayer>().First();
QueuedTask.Run(() =>
{
  //use a local path
  var table = StandaloneTableFactory.Instance.CreateStandaloneTable(
      new Uri(@"C:\Temp\Data\SDK.gdb\EarthquakeDamage", UriKind.Absolute),
      container);
  //use a URI to a feature service table endpoint
  var table2 = StandaloneTableFactory.Instance.CreateStandaloneTable(
    new Uri(@"https://bexdog.esri.com/server/rest/services/FeatureServer" + "/2", UriKind.Absolute),
    container);
  //Use an item
  var item = ItemFactory.Instance.Create(@"C:\Temp\Data\SDK.gdb\ParcelOwners");
  var tableCreationParams = new StandaloneTableCreationParams(item);
  var table3 = StandaloneTableFactory.Instance.CreateStandaloneTable(tableCreationParams, container);

  //use table creation params
  var table_params = new StandaloneTableCreationParams(item)
  {
    // At 2.x - DefinitionFilter = new CIMDefinitionFilter()
    //{
    //  //optional - use a filter
    //  DefinitionExpression = "LAND_USE = 3"
    //}
    DefinitionQuery = new DefinitionQuery(whereClause: "LAND_USE = 3", name: "Landuse")
  };
  var table4 = StandaloneTableFactory.Instance.CreateStandaloneTable(table_params,
                           container);

});

Requirements

Target Platforms: Windows 11, Windows 10, Windows 8.1

Reference

StandaloneTableFactory Class
StandaloneTableFactory Members
Overload List

Send feedback