AssociationAttribute Class
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Specifies that an entity member represents a data relationship, such as a foreign key relationship.
Inheritance Hierarchy
System.Object
System.Attribute
System.ComponentModel.DataAnnotations.AssociationAttribute
Namespace: System.ComponentModel.DataAnnotations
Assembly: System.ComponentModel.DataAnnotations (in System.ComponentModel.DataAnnotations.dll)
Syntax
'Declaration
<AttributeUsageAttribute(AttributeTargets.Property Or AttributeTargets.Field, AllowMultiple := False, _
Inherited := True)> _
Public NotInheritable Class AssociationAttribute _
Inherits Attribute
[AttributeUsageAttribute(AttributeTargets.Property|AttributeTargets.Field, AllowMultiple = false,
Inherited = true)]
public sealed class AssociationAttribute : Attribute
The AssociationAttribute type exposes the following members.
Constructors
| Name | Description | |
|---|---|---|
.gif "Public method") |
AssociationAttribute | Initializes a new instance of the AssociationAttribute class. |
Top
Properties
| Name | Description | |
|---|---|---|
.gif "Public property") |
IsForeignKey | Gets or sets the member as the foreign key in an association that represents a data relationship. |
|
Name | Gets the name used to identify the association. |
|
OtherKey | Gets a comma-separated list of the property names of the key values on the other side of the association. |
|
OtherKeyMembers | Gets the collection of individual key values specified in the OtherKey property. |
|
ThisKey | Gets a comma-separated list of property names of the key values on this side of the association. |
|
ThisKeyMembers | Gets the collection of individual key values specified in the ThisKey property. |
Top
Methods
| Name | Description | |
|---|---|---|
|
Equals | Infrastructure. Returns a value that indicates whether this instance is equal to a specified object. (Inherited from Attribute.) |
.gif "Protected method") |
Finalize | Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.) |
|
GetHashCode | Returns the hash code for this instance. (Inherited from Attribute.) |
|
GetType | Gets the Type of the current instance. (Inherited from Object.) |
|
Match | When overridden in a derived class, returns a value that indicates whether this instance equals a specified object. (Inherited from Attribute.) |
|
MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
|
ToString | Returns a string that represents the current object. (Inherited from Object.) |
Top
Remarks
You apply the AssociationAttribute attribute to the property that represents the data relationship. The property that represents the relationship is usually a collection of objects representing the related class. When applying the attribute, you assign a name for the relationship and the keys associated on both sides of the relationship. For bidirectional associations, the name must be the same on both sides of the association.
When you apply an AssociationAttribute to a member in a WCF RIA Services solution, you must define the same number of keys on both sides of the relationship. If you do not provide the same number of keys to both sides of the relationship, you will receive an error when building the solution.
Version Information
Silverlight
Supported in: 5, 4, 3
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.
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.
See Also