SPFieldLink - Constructeur

Article
05/12/2015

Initialise une nouvelle instance de la classe SPFieldLink avec le champ spécifié.

Espace de noms : Microsoft.SharePoint
Assembly : Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

'Déclaration
Public Sub New ( _
    field As SPField _
)
'Utilisation
Dim field As SPField

Dim instance As New SPFieldLink(field)

public SPFieldLink(
    SPField field
)

Paramètres

field
Type : Microsoft.SharePoint.SPField

Une colonne à référencer. Notez que cet objet doit représenter un site existant ou une colonne de liste. En d'autres termes, elle doit être contenue dans l'objet SPFieldCollection qui est retourné par la propriété SPWeb.Fields ou SPList.Fields .

Remarques

Lors de la création d'un objet SPFieldLink , certaines de ses propriétés sont initialisées aux valeurs des propriétés correspondantes de l'objet SPField qui est transmis en tant qu'argument au constructeur. Les propriétés et leurs valeurs sont répertoriés dans le tableau suivant.

Propriété	Valeur comprise entre
Hidden	SPField.Hidden
Id	SPField.Id
Name	SPField.InternalName
Required	SPField.Required

Exemples

L'exemple suivant montre une partie d'une application console qui ajoute un objet SPField à SPFieldCollection, du site puis utilise l'objet pour créer un objet SPFieldLink et ajoute cet objet à SPFieldLinkCollection d'un type contenu.

Notez que, avant de pouvoir utiliser un nouveau champ pour créer un objet SPFieldLink , le champ doit être un membre d'une collection de champs au niveau du site ou de liste.

Dim site As SPSite = New SPSite("https://localhost")
Dim web As SPWeb = site.OpenWeb()

' Get the site content type collection.
Dim contentTypes As SPContentTypeCollection = web.ContentTypes

' Create a Customer content type derived from the Contact content type.
Dim contentType As SPContentType = New SPContentType(contentTypes("Contact"), contentTypes, "Customer")

' Add the content type to the site collection.
contentTypes.Add(contentType)

' Get the site fields (columns) collection.
Dim siteFields As SPFieldCollection = web.Fields

' Create a new field (column) and add it to the site collection.
Dim fieldName As String = siteFields.Add("Last Order", _
                                          SPFieldType.DateTime, False)

' Create a reference to the new field.
Dim fieldLink As SPFieldLink = _
                        New SPFieldLink(siteFields.GetField(fieldName))

' Add the field reference to the content type.
contentType.FieldLinks.Add(fieldLink)

' Commit changes to the content type.
contentType.Update()

' Clean up.
web.Dispose()
site.Dispose()

SPSite site = new SPSite("https://localhost");
SPWeb web = site.OpenWeb();

// Get the site content type collection.
SPContentTypeCollection contentTypes = web.ContentTypes;

// Create a Customer content type derived from the Contact content type.
SPContentType contentType = new SPContentType(contentTypes["Contact"],
                                              contentTypes, "Customer");

// Add the content type to the site collection.
contentTypes.Add(contentType);

// Get the site fields (columns) collection.
SPFieldCollection siteFields = web.Fields;

// Create a new field (column) and add it to the site collection.
string fieldName = siteFields.Add("Last Order", SPFieldType.DateTime, false);

// Create a reference to the new field.
SPFieldLink fieldLink = new SPFieldLink(siteFields.GetField(fieldName));

// Add the field reference to the content type.
contentType.FieldLinks.Add(fieldLink);

// Commit changes to the content type.
contentType.Update();

// Clean up.
web.Dispose();
site.Dispose();