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


Create A SchematicAttributeAssociatedField On A Schematic Element Class Snippet (ArcObjects .NET 10.6 SDK)
ArcObjects Library Reference

Create A SchematicAttributeAssociatedField On A Schematic Element Class Snippet

Create an associated field SchematicAttribute on a given SchematicElementClass

[C#]
        /// <summary>
        /// Create an associated field SchematicAttribute on a given SchematicElementClass
        /// </summary>
        /// <param name="schElementClass">The SchematicElementClass where the associated field attribute is created</param>
        /// <param name="AttributeName">The ISchematicAttributeAssociatedField 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="AssociatedFieldName">The AssociatedFieldName for the created schematic attribute</param>
        /// <returns>The created ESRI.ArcGIS.Schematic.ISchematicAttributeAssociatedField</returns>
        /// <remarks>The UID.Value is a contant GUID value for the ISchematicAttributeAssociatedField type of schematic attribute</remarks>
        public ESRI.ArcGIS.Schematic.ISchematicAttributeAssociatedField CreateAttributeAssociatedFieldForElementClass(ESRI.ArcGIS.Schematic.ISchematicElementClass schElementClass, string AttributeName, ESRI.ArcGIS.Schematic.esriSchematicAttributeEvaluationMode EvalMode, ESRI.ArcGIS.Schematic.esriSchematicAttributeStorageMode StorageMode, string AssociatedFieldName)
        {

                ESRI.ArcGIS.Schematic.ISchematicAttribute schAttribute=null;
                try
                // create an ISchematicAttribute
                {
                        ESRI.ArcGIS.esriSystem.UID pUid=new ESRI.ArcGIS.esriSystem.UID();
                        pUid.Value="{7DE3A19D-32D0-41cd-B896-37CA3AFBD88A}";
                        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 ISchematicAttributeAssociatedField and set its properties
                ESRI.ArcGIS.Schematic.ISchematicAttributeAssociatedField schAttAssociatedField=(ESRI.ArcGIS.Schematic.ISchematicAttributeAssociatedField)schAttribute;
                if (schAttAssociatedField != null)
                {
                        schAttAssociatedField.AssociatedFieldName=AssociatedFieldName;
                }

                return schAttAssociatedField;
        }
[Visual Basic .NET]
  ''' <summary>
        ''' Create an associated field SchematicAttribute on a given SchematicElementClass
        ''' </summary>
        ''' <param name="schElementClass">The SchematicElementClass where the associated field attribute is created</param>
        ''' <param name="AttributeName">The ISchematicAttributeAssociatedField 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="AssociatedFieldName">The AssociatedFieldName for the created schematic attribute</param>
        ''' <returns>The created ESRI.ArcGIS.Schematic.ISchematicAttributeAssociatedField</returns>
        ''' <remarks>The UID.Value is a contant GUID value for the ISchematicAttributeAssociatedField type of schematic attribute</remarks>
        Public Function CreateAttributeAssociatedFieldForElementClass(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 AssociatedFieldName As String) As ESRI.ArcGIS.Schematic.ISchematicAttributeAssociatedField

                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="{7DE3A19D-32D0-41cd-B896-37CA3AFBD88A}"
                        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 ISchematicAttributeAssociatedField and set its properties
                Dim schAttAssociatedField As ESRI.ArcGIS.Schematic.ISchematicAttributeAssociatedField=TryCast(schAttribute, ESRI.ArcGIS.Schematic.ISchematicAttributeAssociatedField)
                If (schAttAssociatedField IsNot Nothing) Then
                        schAttAssociatedField.AssociatedFieldName=AssociatedFieldName
                End If

                Return schAttAssociatedField
        End Function

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