RelationName

virtual string System.Data.DataRelation.RelationName

getset

Definition at line 132 of file DataRelation.cs.

    {
        get
        {
            CheckStateForProperty();
            return _relationName;
        }
        [param: AllowNull]
        set
        {
            long scopeId = DataCommonEventSource.Log.EnterScope("<ds.DataRelation.set_RelationName|API> {0}, '{1}'", ObjectID, value);
            try
            {
                if (value == null)
                {
                    value = string.Empty;
                }
                CultureInfo culture = ((_dataSet != null) ? _dataSet.Locale : CultureInfo.CurrentCulture);
                if (string.Compare(_relationName, value, ignoreCase: true, culture) != 0)
                {
                    if (_dataSet != null)
                    {
                        if (value.Length == 0)
                        {
                            throw ExceptionBuilder.NoRelationName();
                        }
                        _dataSet.Relations.RegisterName(value);
                        if (_relationName.Length != 0)
                        {
                            _dataSet.Relations.UnregisterName(_relationName);
                        }
                    }
                    _relationName = value;
                    ((DataRelationCollection.DataTableRelationCollection)ParentTable.ChildRelations).OnRelationPropertyChanged(new CollectionChangeEventArgs(CollectionChangeAction.Refresh, this));
                    ((DataRelationCollection.DataTableRelationCollection)ChildTable.ParentRelations).OnRelationPropertyChanged(new CollectionChangeEventArgs(CollectionChangeAction.Refresh, this));
                }
                else if (string.Compare(_relationName, value, ignoreCase: false, culture) != 0)
                {
                    _relationName = value;
                    ((DataRelationCollection.DataTableRelationCollection)ParentTable.ChildRelations).OnRelationPropertyChanged(new CollectionChangeEventArgs(CollectionChangeAction.Refresh, this));
                    ((DataRelationCollection.DataTableRelationCollection)ChildTable.ParentRelations).OnRelationPropertyChanged(new CollectionChangeEventArgs(CollectionChangeAction.Refresh, this));
                }
            }
            finally
            {
                DataCommonEventSource.Log.ExitScope(scopeId);
            }
        }
    }

Referenced by System.Data.DataRelationCollection.DataSetRelationCollection.AddCore(), System.Data.RelationshipConverter.ConvertTo(), System.Data.DataRelationCollection.InternalIndexOf(), System.Data.DataRelationCollection.DataSetRelationCollection.RemoveCore(), System.Data.DataRelationCollection.RemoveCore(), and System.Data.DataRelation.ToString().