This document is archived and information here might be outdated.  Recommended version.


Create A SchematicAttributeField On A Schematic Element Class Snippet (ArcObjects .NET 10.4 SDK)
ArcObjects Library Reference

Create A SchematicAttributeField On A Schematic Element Class Snippet

Create a field SchematicAttribute on a given SchematicElementClass

[C#]
        /// <summary>
        /// Create a field SchematicAttribute on a given SchematicElementClass
        /// </summary>
        /// <param name="schElementClass">The SchematicElementClass where the field attribute is created</param>
        /// <param name="AttributeName">The ISchematicAttributeField name</param>
        /// <param name="EvalMode">The EvaluationMode for the created schematic attribute</param>
        /// <param name="StorageMode">The StorageMode for the created schematic attribute</param>
        /// <param name="value">The FieldNames for the created schematic attribute</param>
        /// <returns>The created ESRI.ArcGIS.Schematic.ISchematicAttributeField</returns>
        /// <remarks>The UID.Value is a contant GUID value for the ISchematicAttributeField type of schematic attribute</remarks>
        public ESRI.ArcGIS.Schematic.ISchematicAttributeField CreateAttributeFieldForElementClass(ESRI.ArcGIS.Schematic.ISchematicElementClass schElementClass, string AttributeName, ESRI.ArcGIS.Schematic.esriSchematicAttributeEvaluationMode EvalMode, ESRI.ArcGIS.Schematic.esriSchematicAttributeStorageMode StorageMode, string[] value)
        {

                ESRI.ArcGIS.Schematic.ISchematicAttribute schAttribute=null;
                try
                // create an ISchematicAttribute
                {
                        ESRI.ArcGIS.esriSystem.UID pUid=new ESRI.ArcGIS.esriSystem.UID();
                        pUid.Value="{E1902BB0-6070-4EE2-995A-DB86FAC5EEB0}";
                        schAttribute=schElementClass.CreateSchematicAttribute(AttributeName, pUid);

                }
                catch
                {
                        return null;
                }

                ESRI.ArcGIS.Schematic.ISchematicAttributeManagement schAttributeMngt=(ESRI.ArcGIS.Schematic.ISchematicAttributeManagement)schAttribute;
                try
                {
                        // the StorageMode must be set before the EvaluationMode 
                        // consistenty is checked when the EvaluationMode is set 
                        schAttributeMngt.StorageMode=StorageMode;
                        schAttributeMngt.EvaluationMode=EvalMode;
                }
                catch
                {
                        // an error is returned if the StorageMode and EvaluationMode are not consistent
                }

                // cast SchematicAttribute into ISchematicAttributeField and set its properties
                ESRI.ArcGIS.Schematic.ISchematicAttributeField schAttField=(ESRI.ArcGIS.Schematic.ISchematicAttributeField)schAttribute;
                if (schAttField != null)
                {
                        schAttField.FieldNames=value;
                }

                return schAttField;
        }
[Visual Basic .NET]
        ''' <summary>
        ''' Create a field SchematicAttribute on a given SchematicElementClass
        ''' </summary>
        ''' <param name="schElementClass">The SchematicElementClass where the field attribute is created</param>
        ''' <param name="AttributeName">The ISchematicAttributeField name</param>
        ''' <param name="EvalMode">The EvaluationMode for the created schematic attribute</param>
        ''' <param name="StorageMode">The StorageMode for the created schematic attribute</param>
        ''' <param name="value">The FieldNames for the created schematic attribute</param>
        ''' <returns>The created ESRI.ArcGIS.Schematic.ISchematicAttributeField</returns>
        ''' <remarks>The UID.Value is a contant GUID value for the ISchematicAttributeField type of schematic attribute</remarks>
        Public Function CreateAttributeFieldForElementClass(ByVal schElementClass As ESRI.ArcGIS.Schematic.ISchematicElementClass, ByVal AttributeName As String, ByVal EvalMode As ESRI.ArcGIS.Schematic.esriSchematicAttributeEvaluationMode, ByVal StorageMode As ESRI.ArcGIS.Schematic.esriSchematicAttributeStorageMode, ByVal value() As String) As ESRI.ArcGIS.Schematic.ISchematicAttributeField

                Dim schAttribute As ESRI.ArcGIS.Schematic.ISchematicAttribute=Nothing
                Try
                        ' create an ISchematicAttribute
                        Dim pUid As ESRI.ArcGIS.esriSystem.UID=New ESRI.ArcGIS.esriSystem.UID()
                        pUid.Value="{E1902BB0-6070-4EE2-995A-DB86FAC5EEB0}"
                        schAttribute=schElementClass.CreateSchematicAttribute(AttributeName, pUid)

                Catch
                        Return Nothing
                End Try

                Dim schAttributeMngt As ESRI.ArcGIS.Schematic.ISchematicAttributeManagement=TryCast(schAttribute, ESRI.ArcGIS.Schematic.ISchematicAttributeManagement)
                Try
                        ' the StorageMode must be set before the EvaluationMode 
                        ' consistenty is checked when the EvaluationMode is set 
                        schAttributeMngt.StorageMode=StorageMode
                        schAttributeMngt.EvaluationMode=EvalMode
                Catch
                        ' an error is returned if the StorageMode and EvaluationMode are not consistent
                End Try

                ' cast SchematicAttribute into ISchematicAttributeField and set its properties
                Dim schAttField As ESRI.ArcGIS.Schematic.ISchematicAttributeField=TryCast(schAttribute, ESRI.ArcGIS.Schematic.ISchematicAttributeField)
                If (schAttField IsNot Nothing) Then
                        schAttField.FieldNames=value
                End If

                Return schAttField
        End Function

Additional Requirements
  • The code in this document requires the following References added to the Visual Studio project:
  • ESRI.ArcGIS.Schematic