Nested

virtual bool System.Data.DataRelation.Nested

getset

Definition at line 183 of file DataRelation.cs.

    {
        get
        {
            CheckStateForProperty();
            return _nested;
        }
        set
        {
            long scopeId = DataCommonEventSource.Log.EnterScope("<ds.DataRelation.set_Nested|API> {0}, {1}", ObjectID, value);
            try
            {
                if (_nested == value)
                {
                    return;
                }
                if (_dataSet != null && value)
                {
                    if (ChildTable.IsNamespaceInherited())
                    {
                        CheckNamespaceValidityForNestedRelations(ParentTable.Namespace);
                    }
                    ChildTable.Constraints.FindForeignKeyConstraint(ChildKey.ColumnsReference, ParentKey.ColumnsReference)?.CheckConstraint();
                    ValidateMultipleNestedRelations();
                }
                if (!value && _parentKey.ColumnsReference[0].ColumnMapping == MappingType.Hidden)
                {
                    throw ExceptionBuilder.RelationNestedReadOnly();
                }
                if (value)
                {
                    ParentTable.Columns.RegisterColumnName(ChildTable.TableName, null);
                }
                else
                {
                    ParentTable.Columns.UnregisterName(ChildTable.TableName);
                }
                RaisePropertyChanging("Nested");
                if (value)
                {
                    CheckNestedRelations();
                    if (DataSet != null)
                    {
                        if (ParentTable == ChildTable)
                        {
                            foreach (DataRow row in ChildTable.Rows)
                            {
                                row.CheckForLoops(this);
                            }
                            if (ChildTable.DataSet != null && string.Compare(ChildTable.TableName, ChildTable.DataSet.DataSetName, ignoreCase: true, ChildTable.DataSet.Locale) == 0)
                            {
                                throw ExceptionBuilder.DatasetConflictingName(DataSet.DataSetName);
                            }
                            ChildTable._fNestedInDataset = false;
                        }
                        else
                        {
                            foreach (DataRow row2 in ChildTable.Rows)
                            {
                                row2.GetParentRow(this);
                            }
                        }
                    }
                    ParentTable.ElementColumnCount++;
                }
                else
                {
                    ParentTable.ElementColumnCount--;
                }
                _nested = value;
                ChildTable.CacheNestedParent();
                if (!value || !string.IsNullOrEmpty(ChildTable.Namespace) || (ChildTable.NestedParentsCount <= 1 && (ChildTable.NestedParentsCount <= 0 || ChildTable.DataSet.Relations.Contains(RelationName))))
                {
                    return;
                }
                string text = null;
                foreach (DataRelation parentRelation in ChildTable.ParentRelations)
                {
                    if (parentRelation.Nested)
                    {
                        if (text == null)
                        {
                            text = parentRelation.ParentTable.Namespace;
                        }
                        else if (!string.Equals(text, parentRelation.ParentTable.Namespace, StringComparison.Ordinal))
                        {
                            _nested = false;
                            throw ExceptionBuilder.InvalidParentNamespaceinNestedRelation(ChildTable.TableName);
                        }
                    }
                }
                if (CheckMultipleNested && ChildTable._tableNamespace != null && ChildTable._tableNamespace.Length == 0)
                {
                    throw ExceptionBuilder.TableCantBeNestedInTwoTables(ChildTable.TableName);
                }
                ChildTable._tableNamespace = null;
            }
            finally
            {
                DataCommonEventSource.Log.ExitScope(scopeId);
            }
        }
    }

Referenced by System.Data.DataRelationCollection.DataSetRelationCollection.AddCore(), System.Data.DataRelationCollection.AddCore(), System.Data.DataRelation.Clone(), System.Data.DataRelationCollection.DataSetRelationCollection.RemoveCore(), System.Data.DataRelationCollection.RemoveCore(), and System.Data.DataRelation.ValidateMultipleNestedRelations().