Show / Hide Table of Contents

Method CreateAsync

CreateAsync(IEnumerable<string>, int, SpatialReference?, CancellationToken)

Creates a discrete field from one or more raster files.

Declaration
public static Task<DiscreteField> CreateAsync(IEnumerable<string> filePaths, int band, SpatialReference? spatialReference = null, CancellationToken cancellationToken = default)
Parameters
Type Name Description
IEnumerable<string> filePaths

One or more raster file paths.

int band

Zero-based index identifying a raster band.

SpatialReference spatialReference

The spatial reference into which to project the raster content. Optional.

CancellationToken cancellationToken

A cancellation token that can be used to cancel the operation.

Returns
Type Description
Task<DiscreteField>

A task DiscreteField created from raster files, or an error if creation of a DiscreteField is unsuccessful.

Remarks

If no spatial reference is given, the spatial reference of the first raster file is used.

If a spatial reference is given, the raster content is projected into that spatial reference using the most suitable transformation available. Projection transforms only the horizontal coordinate system, not the field values.

The field extent is the union of the raster file extents.

Supports reading of all raster pixel types except float (32-bit or 64-bit). 32-bit signed integer data is supported for rasters that don't contain values greater than 2147483647. If values exceed this, creation of the field will fail. Throws an exception if creation of a DiscreteField is unsuccessful.

See Also
ExportToFilesAsync(string, string, CancellationToken)
GetTransformationsBySuitability(SpatialReference, SpatialReference)

Applies to

Platforms and versions
TargetVersions
.NET300
.NET Windows300
.NET Android300
.NET iOS300
In this article
Provide feedback
Back to top Copyright © 2025 Esri.