ILayerFactoryHelper.CreateLayersFromName Method

Given a name attempts to open it using the layer factories, if successful returns a layers enumerator.

[Visual Basic .NET]
Public Function CreateLayersFromName ( _
    ByVal Name As IName _
) As IEnumLayer

[C#]
public IEnumLayer CreateLayersFromName (
    IName Name
);

[C++]
HRESULT CreateLayersFromName(
  IName* Name,
  IEnumLayer** Layer
);

[C++]

Parameters
Name [in]

  Name is a parameter of type IName
Layer [out, retval]

  Layer is a parameter of type IEnumLayer

Product Availability

Description

Use this method to create a data Layer or Layers from an IName object. Each IName  instance is passed to CreateLayersFromName to return an enumerator of layers containing a new instance of each layer.

This is typically used for drag and drop. For example, if a feature layer is dragged from an ArcCatalog application and dropped onto the MapControl or PageLayoutControl, objects implementing IName can be extracted from the drop using the IName DataObjectHelper.

Remarks

The CreateLayersFromName method is of limited use to ArcGIS Engine and ArcGIS for Server developers because there is only a small subset of layer factories present and registered in the 'Layer Factory' component category. The CreateLayersFromName method internally iterates the objects in the "Layer Factory" component category and uses the ILayerFactory::CanCreate and ILayerFactory::Create methods.

See Also

.NET Related Topics