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 Err.Number of FDO_E_NO_SCHEMA_LICENSE.

Remarks

CreateCoverage creates  a new ArcInfo 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 exists, and must be a legal ArcInfo 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