ComplexObject Class

.NET Framework (current version)

Other Versions

Base class for complex types.

Namespace: System.Data.Objects.DataClasses
Assembly: System.Data.Entity (in System.Data.Entity.dll)

Inheritance Hierarchy

System::Object
System.Data.Objects.DataClasses::StructuralObject
System.Data.Objects.DataClasses::ComplexObject

Syntax

C++

[SerializableAttribute]
[DataContractAttribute(IsReference = true)]
public ref class ComplexObject abstract : StructuralObject

Constructors

	Name	Description
	ComplexObject()	Creates an instance of ComplexObject.

Methods

	Name	Description
	Equals(Object^)	Determines whether the specified object is equal to the current object.(Inherited from Object.)
	Finalize()	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)
	GetHashCode()	Serves as the default hash function. (Inherited from Object.)
	GetType()	Gets the Type of the current instance.(Inherited from Object.)
	GetValidValue<T>(T, String^, Boolean, Boolean)	Returns a complex type for the specified property.(Inherited from StructuralObject.)
	MemberwiseClone()	Creates a shallow copy of the current Object.(Inherited from Object.)
	OnPropertyChanged(String^)	Raises the PropertyChanged event.(Inherited from StructuralObject.)
	OnPropertyChanging(String^)	Raises the PropertyChanging event.(Inherited from StructuralObject.)
	ReportPropertyChanged(String^)	Notifies the change tracker that a property of a complex object has changed.(Overrides StructuralObject::ReportPropertyChanged(String^).)
	ReportPropertyChanging(String^)	Notifies the change tracker that a property change is pending on a complex object.(Overrides StructuralObject::ReportPropertyChanging(String^).)
	SetValidValue<T>(T, T, String^)	Sets a complex object for the specified property.(Inherited from StructuralObject.)
	ToString()	Returns a string that represents the current object.(Inherited from Object.)

Events

	Name	Description
	PropertyChanged	Occurs when a property value has changed.(Inherited from StructuralObject.)
	PropertyChanging	Occurs when a property value change is a pending.(Inherited from StructuralObject.)

Remarks

ComplexObject implements the basic functionality for complex types. For more information, see Complex Type Objects.

When implementing custom data classes with a conceptual model, we recommend that your data classes that represent complex types inherit from ComplexObject. For more information, see Customizing Objects.

A complex type can be a property of an entity type or of another complex type.

Complex types are returned by non-scalar properties of entity types. This enables scalar properties to be organized within entities. Like entities, complex types consist of scalar properties or other complex type properties. A complex type cannot be used without an associated entity type. Because complex types do not have keys, complex type objects cannot be managed without an associated entity type. For more information, see Complex Type Objects.

Examples

In the following example, the custom data class OrderInfo inherits from ComplexObject and is mapped to the OrderInfo complex type defined in the conceptual model.

C++

No code example is currently available or this language may not be supported.

Version Information

.NET Framework
Available since 3.5

Thread Safety

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.