Share via


SPFieldLinkCollection Class

Represents the collection of column or field references in a content type.

Inheritance Hierarchy

System.Object
  Microsoft.SharePoint.Administration.SPAutoSerializingObject
    Microsoft.SharePoint.SPBaseCollection
      Microsoft.SharePoint.SPFieldLinkCollection

Namespace:  Microsoft.SharePoint
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

<SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel := True)> _
<SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel := True)> _
Public Class SPFieldLinkCollection _
    Inherits SPBaseCollection

Dim instance As SPFieldLinkCollection
[SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel = true)]
[SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel = true)]
public class SPFieldLinkCollection : SPBaseCollection

Remarks

If you want to track specific item metadata in a content type, you can reference a column that represents that metadata. However, you cannot create a column within a content type; you must create the column separately and then reference it in the content type definition. As a result, when you add a column to a content type, the content type contains a reference to the column or field rather than the column or field itself.

The column or field reference contains a subset of the properties of the full field definition. These are the properties that you can customize for the column as it exists in the content type.

For more information, see Fields and Field References.

The SPContentType object contains both a SPFieldLinkCollection and an SPFieldCollection object.

The SPFieldCollection object provides you with a combined view of a column's attributes, as they exist in that content type. Each SPField object represents all the attributes of a column or field definition, combined with those attributes that have been overridden in the field reference for that content type.

When you access an SPField object in a content type, Windows SharePoint Services merges the field definition with the field reference and returns the resulting SPField object. This is helpful because you do not have to look up a field definition and all the attributes in that field definition that are overridden by the field reference for that content type.

There is a 1-to-1 correlation between the items in the SPFieldLinkCollection and SPFieldCollection objects. For each SPFieldLink object that you add to a content type, Windows SharePoint Services adds a corresponding SPField object that represents the merged view of that column, as it is defined in the content type.

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

Reference

SPFieldLinkCollection Members

Microsoft.SharePoint Namespace

SPFieldLink

SPContentType

Other Resources

Fields and Field References

Introduction to Columns