ESRI.ArcGIS.ADF.IMS
AddressValueCollection Class
Members  Example  See Also  Send Feedback
ESRI.ArcGIS.ADF.IMS.Geocode Namespace : AddressValueCollection Class




A thread-safe collection of AddressValues.

Object Model

AddressValueCollection Class

Syntax

Visual Basic (Declaration) 
<DefaultMemberAttribute("Item")>
<SerializableAttribute()>
Public Class AddressValueCollection 
   Inherits ESRI.ArcGIS.ADF.ThreadSafeCollection
Visual Basic (Usage)Copy Code
Dim instance As AddressValueCollection
C# 
[DefaultMemberAttribute("Item")]
[SerializableAttribute()]
public class AddressValueCollection : ESRI.ArcGIS.ADF.ThreadSafeCollection

Example

This example geocodes an address and displays the results in a standard .NET GridView control. Prior to geocoding, the minimum score and maximum candidates are changed from their defaults, and the AddressValueCollection is built by adding AddressValue items based on field input names ("STREET", etc.; these can be obtained from the InputFieldCollection of the Geocoder object). Geocoding returns the results as a FeatureTable. Since the shape field is a point object, it will not display by default in a GridView, so here we add X and Y columns and copy the point's coordinate values into these columns. The point coordinates will then display in the GridView.
C#Copy Code
// Address to geocode
string address = "98 S 2nd St";
string zone = "95113";
 
ESRI.ArcGIS.ADF.IMS.Carto.Layer.FeatureLayer streetLayer =
    (ESRI.ArcGIS.ADF.IMS.Carto.Layer.FeatureLayer) mapView.Layers["2"];
 
// Get the Geocoder from the FeatureLayer
ESRI.ArcGIS.ADF.IMS.Geocode.Geocoder streetGeocoder = streetLayer.Geocoder;
 
if (streetGeocoder != null)
{
    // Set mininum score and maximum candidates
    streetGeocoder.MinScore = 30;
    streetGeocoder.MaxCandidates = 5;
 
    ESRI.ArcGIS.ADF.IMS.Geocode.AddressValueCollection valColl
        = new ESRI.ArcGIS.ADF.IMS.Geocode.AddressValueCollection();
    ESRI.ArcGIS.ADF.IMS.Geocode.AddressValue addrVal;
 
    // Add geocoding values to value collection (can get FieldID from InputField)
    addrVal = new ESRI.ArcGIS.ADF.IMS.Geocode.AddressValue("STREET", address);
    valColl.Add(addrVal);
    addrVal = new ESRI.ArcGIS.ADF.IMS.Geocode.AddressValue("ZONE", zone);
    valColl.Add(addrVal);
 
    // Do geocoding with the value collection
    ESRI.ArcGIS.ADF.IMS.Carto.Layer.FeatureTable geocodeResults
        = streetGeocoder.Geocode(valColl);
 
    if (geocodeResults.Rows.Count > 0)
    {
        // Add x and y fields to the feature table
        DataColumn xCol = new DataColumn("X", typeof(Double));
        DataColumn yCol = new DataColumn("Y", typeof(Double));
        geocodeResults.Columns.Add(xCol);
        geocodeResults.Columns.Add(yCol);
 
        ESRI.ArcGIS.ADF.IMS.Geometry.Point pt;
 
        // Copy the x and y values from the point geometry to the x/y fields
        foreach (DataRow row in geocodeResults.Rows)
        {
            pt = (ESRI.ArcGIS.ADF.IMS.Geometry.Point)row["#SHAPE#"];
            row["X"] = pt.X;
            row["Y"] = pt.Y;
        }
        
        GridView1.DataSource = geocodeResults;
        GridView1.DataBind();
    }
    else
        Label1.Text = "No matching locations found for the address.";
}
Visual BasicCopy Code
' Address to geocode
Dim address As String = "98 S 2nd St"
Dim zone As String = "95113"
 
Dim streetLayer As ESRI.ArcGIS.ADF.IMS.Carto.Layer.FeatureLayer = _
    CType(mapView.Layers("2"), _
    ESRI.ArcGIS.ADF.IMS.Carto.Layer.FeatureLayer)
 
' Get the Geocoder from the FeatureLayer
Dim streetGeocoder As ESRI.ArcGIS.ADF.IMS.Geocode.Geocoder _
    = streetLayer.Geocoder
 
If Not IsNothing(streetGeocoder) Then
 
    ' Set mininum score and maximum candidates
    streetGeocoder.MinScore = 30
    streetGeocoder.MaxCandidates = 5
 
    Dim valColl As New ESRI.ArcGIS.ADF.IMS.Geocode.AddressValueCollection()
    Dim addrVal As ESRI.ArcGIS.ADF.IMS.Geocode.AddressValue addrVal
 
    ' Add geocoding values to value collection (can get FieldID from InputField)
    addrVal = New ESRI.ArcGIS.ADF.IMS.Geocode.AddressValue("STREET", address)
    valColl.Add(addrVal)
    addrVal = New ESRI.ArcGIS.ADF.IMS.Geocode.AddressValue("ZONE", zone)
    valColl.Add(addrVal)
    
    ' Do geocoding with the value collection
    Dim geocodeResults As ESRI.ArcGIS.ADF.IMS.Carto.Layer.FeatureTable _
        = streetGeocoder.Geocode(valColl)
 
    If geocodeResults.Rows.Count > 0 Then
    
        ' Add x and y fields to the feature table
        Dim xCol As New DataColumn("X", GetType(Double))
        Dim yCol As New DataColumn("Y", GetType(Double))
        geocodeResults.Columns.Add(xCol)
        geocodeResults.Columns.Add(yCol)
 
        Dim pt As ESRI.ArcGIS.ADF.IMS.Geometry.Point
 
        ' Copy the x and y values from the point geometry to the x/y fields
        For Each row As DataRow In geocodeResults.Rows
        
            pt = CType(row("#SHAPE#"), ESRI.ArcGIS.ADF.IMS.Geometry.Point)
            row("X") = pt.X
            row("Y") = pt.Y
        Next row
    
        GridView1.DataSource = geocodeResults
        GridView1.DataBind()
    
    Else
        Label1.Text = "No matching locations found for the address."
    End If
End If

Remarks

Geocoding is performed by creating an AddressValueCollection and sending it to the server by the Geocode method of Geocoder.

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2011 All Rights Reserved.