Click or drag to resize

RuntimeImageExtensionsToImageSourceAsync Method

Converts a RuntimeImage to a platform-native image type.

Namespace:  Esri.ArcGISRuntime.UI
Assembly:  Esri.ArcGISRuntime (in Esri.ArcGISRuntime.dll) Version:
public static Task<Bitmap> ToImageSourceAsync(
	this RuntimeImage image


Type: Esri.ArcGISRuntime.UIRuntimeImage
Runtime Image to convert

Return Value

Type: TaskAndroid.Graphics.Bitmap
A native platform bitmap image

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type RuntimeImage. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).


Example Name: ReadShapefileMetadata

Read a shapefile and display its metadata.

Code example screen shot.

// Copyright 2017 Esri.
// Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
// You may obtain a copy of the License at:
// Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an
// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific
// language governing permissions and limitations under the License.

using System;
using Android.App;
using Android.Graphics;
using Android.OS;
using Android.Views;
using Android.Widget;
using Esri.ArcGISRuntime.Data;
using Esri.ArcGISRuntime.Mapping;
using Esri.ArcGISRuntime.UI.Controls;
using ArcGISRuntime.Samples.Managers;
using Esri.ArcGISRuntime.UI;
using ContextThemeWrapper = Android.Support.V7.View.ContextThemeWrapper;

namespace ArcGISRuntime.Samples.ReadShapefileMetadata
    [Activity (ConfigurationChanges=Android.Content.PM.ConfigChanges.Orientation | Android.Content.PM.ConfigChanges.ScreenSize)]
        "Read shapefile metadata",
        "This sample demonstrates how to open a shapefile stored on the device, read metadata that describes the dataset, and display it as a feature layer with default symbology.",
        "The shapefile will be downloaded from an ArcGIS Online portal automatically.",
    public class ReadShapefileMetadata : Activity
        // Store the app's map view
        private MapView _myMapView;

        // Store the object that holds the shapefile metadata
        private ShapefileInfo _shapefileMetadata;

        protected override void OnCreate(Bundle bundle)

            Title = "Read shapefile metadata";

            // Download (if necessary) and add a local shapefile dataset to the map

        private async void Initialize()
            // Create a new map to display in the map view with a streets basemap
            Map streetMap = new Map(Basemap.CreateStreets());

            // Get the path to the downloaded shapefile
            string filepath = GetShapefilePath();

                // Open the shapefile
                ShapefileFeatureTable myShapefile = await ShapefileFeatureTable.OpenAsync(filepath);

                // Read metadata about the shapefile and display it in the UI
                _shapefileMetadata = myShapefile.Info;

                // Create a feature layer to display the shapefile
                FeatureLayer newFeatureLayer = new FeatureLayer(myShapefile);
                await newFeatureLayer.LoadAsync();

                // Zoom the map to the extent of the shapefile
                _myMapView.SpatialReferenceChanged += async (s, e) =>
                    await _myMapView.SetViewpointGeometryAsync(newFeatureLayer.FullExtent);

                // Add the feature layer to the map

                // Show the map in the MapView
                _myMapView.Map = streetMap;
            catch (Exception e)
                new AlertDialog.Builder(this).SetMessage(e.ToString()).SetTitle("Error").Show();

        private static string GetShapefilePath()
            return DataManager.GetDataFolder("d98b3e5293834c5f852f13c569930caa", "TrailBikeNetwork.shp");

        private void CreateLayout()
            // Create a new vertical layout for the app
            LinearLayout layout = new LinearLayout(this) { Orientation = Orientation.Vertical };

            // Add a button to show the metadata
            Button showMetadataButton = new Button(this)
                Text = "Show Metadata"
            showMetadataButton.Click += ShowMetadataDialog;

            // Add the map view to the layout
            _myMapView = new MapView(this);

            // Show the layout in the app

        private void ShowMetadataDialog(object sender, System.EventArgs e)
            MetadataDialogFragment metadataDialog = new MetadataDialogFragment(_shapefileMetadata);

            // Begin a transaction to show a UI fragment (the metadata dialog)
            FragmentTransaction trans = FragmentManager.BeginTransaction();
            metadataDialog.Show(trans, "metadata");

    // A custom DialogFragment class to show shapefile metadata
    public class MetadataDialogFragment : DialogFragment
        private ShapefileInfo _metadata;
        private ImageView _thumbnailImageView;

        public MetadataDialogFragment(ShapefileInfo metadata)
            _metadata = metadata;

        public override View OnCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)
            base.OnCreateView(inflater, container, savedInstanceState);

            // Dialog to display
            LinearLayout dialogView = null;

            // Get the context for creating the dialog controls
            Android.Content.Context ctx = Activity.ApplicationContext;
            Android.Support.V7.View.ContextThemeWrapper ctxWrapper = new ContextThemeWrapper(ctx, Android.Resource.Style.ThemeMaterialLight);

            // Set a dialog title

            // The container for the dialog is a vertical linear layout
            dialogView = new LinearLayout(ctxWrapper)
                Orientation = Orientation.Vertical
            dialogView.SetPadding(20, 20, 20, 20);

            // Add a text box for showing metadata summary
            TextView summaryTextView = new TextView(ctxWrapper)
                Text = _metadata.Summary

            // Add an image to show the thumbnail
            _thumbnailImageView = new ImageView(ctxWrapper);

            // Call a function to load the thumbnail image from the metadata

            // Add a text box for showing metadata tags
            TextView tagsTextView = new TextView(ctxWrapper)
                Text = string.Join(",", _metadata.Tags)

            // Add a button to close the dialog
            Button dismissButton = new Button(ctxWrapper)
                Text = "OK"
            dismissButton.Click += (s,e)=> Dismiss();

            // Return the new view for display
            return dialogView;

        private async void LoadThumbnail()
                Bitmap img = await _metadata.Thumbnail.ToImageSourceAsync();
            catch (Exception e)
                new AlertDialog.Builder(Context).SetMessage(e.ToString()).SetTitle("Error").Show();
See Also