GDSData

A GDSData instance is used whenever you need to export data from or import data into a GeoDataServer object.

Property	Type	Description
Compressed	bool	Returns true if the data has been compressed. Compressed data is stored in the .zip format.
ConnectionProperties	PropertySet	The connection properties needed to connect to the URL specified in the URL property. This property does not need to be set if the data is embedded or if the URL allows anonymous access. If the URL has HTTP authentication enabled, then it is recommended you use an encrypted communication channel which can be enabled through SSL.
EmbeddedData	byte[]	Returns a byte array with the actual data if the transport type is embedded.
TransportType	esriGDSTransportType	The transport type used to transfer the replica data.
URL	string	The URL is used to specify the location of the local or virtual directory where the data is located. This is not set when the TransportType of embedded.

Remarks

This GDSData class acts as a data carrier. Export operations, such as ExportReplicaDataChanges or CreateReplica, will return a GDSData instance. Import operations, such as ImportReplicaSchemaChanges or ImportAcknowledgement, will take a GDSData instance as an argument.

When exporting, use the TransportType property to determine how the data was exported. If it was exported embedded ("esriGDSTransportTypeEmbedded") then the data exists in memory as a byte array. You can then use the EmbeddedData property to get the byte array and write it to a file. If it was exported to a URL ("esriGDSTransportTypeURL") then an export file with the data has been written to the virtual directory of the GIS server. The URL property returns the virtual directory location. The Compressed property returns whether or not the data has been compressed. The ConnectionProperties will contain the connection information for the GeoDataServer.

When importing, you must initialize the GDSData class appropriately by setting the properties of the IGDSData interface. If importing from a file at a URL or in a local directory, you need to set the URL property to the file location. You must also set the TransportType to "URL". If importing from a byte array, you need to set the EmbeddedData property with the byte array and set TransportType to "Embedded".

If using "URL", note that the GeoDataServer must be able to access the file location. For example, if importing from a local file into a GeoDataServer accessed through ArcGIS server, you must use embedded. This is because the GeoDataServer will not be able to access the local file directory as specified by the URL property.

When importing, you must also set Compressed to true if the data is compressed or false if the data is not compressed. If importing from a secure server you also need to set the ConnectionProperties with the proper credentials to access the data.