This document is archived and information here might be outdated.  Recommended version.


IArcInfoWorkspace.CreateCoverage Method (ArcObjects .NET 10.4 SDK)
ArcObjects Library Reference (DataSourcesFile)  

IArcInfoWorkspace.CreateCoverage Method

Creates a new Coverage.

[Visual Basic .NET]
Public Function CreateCoverage ( _
    ByVal Name As String, _
    ByVal templateCoverage As String, _
    ByVal precision As esriCoveragePrecisionType _
) As IFeatureDataset
[C#]
public IFeatureDataset CreateCoverage (
    string Name,
    string templateCoverage,
    esriCoveragePrecisionType precision
);
[C++]
HRESULT CreateCoverage(
  BSTR Name,
  BSTR templateCoverage,
  esriCoveragePrecisionType precision,
  IFeatureDataset** featureDataset
);
[C++]

Parameters Name [in] Name is a parameter of type BSTR templateCoverage [in] templateCoverage is a parameter of type BSTR precision [in]
precision is a parameter of type esriCoveragePrecisionType featureDataset [out, retval]
featureDataset is a parameter of type IFeatureDataset

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Errors Returned

This method will return an error if:

Coverage Name is a path, ex "D:\data\canada" , if it is longer than 13 characters, or if it exists.

Functional License Check

If your application/site is not appropriately licensed, CreateCoverage can return an error of FDO_E_NO_SCHEMA_LICENSE.

Remarks

CreateCoverage creates  a new ArcGIS for Desktop Advanced coverage in the workspace that is being referenced. The IFeatureDataset that is returned can be used to create new feature classes within the coverage.

The coverage name cannot be a path, cannot exist, and must be a legal ArcGIS for Desktop Advanced coverage name.

If a templatecoverage is not specified or the name is not a valid coverage, the new coverage will only have an empty Tic file. When a template coverage is used, the new coverage will have the same Tics, bnd (boundary), and prj (projection).

The precision enumerator is used to specify whether the coverage has single (7 significant digits for each coordinate) or double precision (15 significant digits for each coordinate).

 

See Also

IArcInfoWorkspace Interface