Class S100MapExtensions
Extension entry point that attaches a reusable S-100 subsystem to a Mapsui.Map.
public static class S100MapExtensions
- Inheritance
-
S100MapExtensions
- Inherited Members
Methods
AddS100(Map, S100MapsuiOptions?)
Attaches an S-100 subsystem to map and returns the
disposable session that owns it. The session composes and owns the layer
bands, processor ownership, dataset renderer, dataset-layer session, and
navigation surface; disposing the returned instance releases all of them.
public static IS100MapSession AddS100(this Map map, S100MapsuiOptions? options = null)
Parameters
mapMapThe Mapsui map to attach to.
optionsS100MapsuiOptionsOptional rendering configuration. When null, defaults are used. Supply CrsTransformFactory (or a prebuilt DatasetRenderer) so a renderer can be built. A DI host can also share its own ProcessorOwner and DatasetRenderer here so the session composes over the same instances other services use.
Returns
- IS100MapSession
The owned, disposable S-100 session.
Remarks
Ownership lives only on the returned instance — it is not stored in a
static table or Map.Tag. Collaborators supplied on
options are borrowed: the session never disposes an
injected ProcessorOwner (the renderer is
not disposable), so a DI host retains their lifetime. Normal pan, zoom,
and rotation remain available through Map.Navigator. This first API
renders caller-supplied processors via
AddDatasetAsync(MapDataset, IDatasetProcessor, int?, int?, CancellationToken); file/exchange-set loading
and DI registration helpers are later additions.
Exceptions
- ArgumentNullException
mapis null.- ArgumentException
Neither CrsTransformFactory nor DatasetRenderer is supplied, so no renderer can be built.