SPFieldLinkCollection.Add - Méthode

Article
05/12/2015

Ajoute un objet SPFieldLink à la collection.

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

Syntaxe

'Déclaration
Public Sub Add ( _
    fieldLink As SPFieldLink _
)
'Utilisation
Dim instance As SPFieldLinkCollection
Dim fieldLink As SPFieldLink

instance.Add(fieldLink)

public void Add(
    SPFieldLink fieldLink
)

Paramètres

fieldLink
Type : Microsoft.SharePoint.SPFieldLink

La référence de champ à ajouter à la collection. L'argument ne doit pas être null .

Exceptions

Exception	Condition
SPException	La valeur de la propriété Name de l'objet que vous ajoutez à la collection duplique la valeur de la propriété Name pour un objet qui existe déjà dans la collection. - ou - L'objet SPFieldLink fait référence à un champ qui est hors de portée pour ce type de contenu.

SPException

La valeur de la propriété Name de l'objet que vous ajoutez à la collection duplique la valeur de la propriété Name pour un objet qui existe déjà dans la collection.

- ou -

L'objet SPFieldLink fait référence à un champ qui est hors de portée pour ce type de contenu.

Remarques

Objets de la collection sont indexés par nom interne (la valeur de la propriété SPFieldLink.Name ). Si vous essayez d'ajouter un objet qui a le même nom interne sous la forme d'un objet qui existe déjà dans la collection, la méthode lève une exception. Étant donné que la valeur de la propriété SPFieldLink.Name est la même que la propriété InternalName de l'objet SPField qu'il référence, cette restriction garantit qu'un type de contenu ne peut pas référencer le même champ deux fois.

Vous ne pouvez pas ajouter directement un champ de type SPFieldLookup s'il s'agit d'une recherche secondaire (c'est-à-dire, si la propriété IsDependentLookup retourne true). Pour ajouter des champs de recherche secondaire dans une recherche de plusieurs colonnes, ajoutez le champ de recherche principal (la propriété IsDependentLookup retourne false). Tous les champs de recherche secondaire qui dépendent du champ de recherche principal sont automatiquement ajoutés.

Exemples

L'exemple suivant montre une méthode qui vérifie si un type de contenu a déjà un lien à un champ. Si elle n'est pas le cas, la méthode crée un lien et l'ajoute à la collection du type de contenu.

L'application qui inclut cet exemple importe les espaces de noms System et Microsoft.Sharepoint .

Function LinkToField(ByRef field As SPField, ByRef contentType As SPContentType) As SPFieldLink
    ' Is the FieldLink in the collection?
    Dim fieldLink As SPFieldLink = contentType.FieldLinks(field.Id)
    If fieldLink Is Nothing Then ' No, so add it.
        fieldLink = New SPFieldLink(field)
        contentType.FieldLinks.Add(fieldLink)
    End If
    Return fieldLink
End Function

static SPFieldLink LinkToField(SPField field, SPContentType contentType)
{
    // Is the FieldLink in the collection?
    SPFieldLink fieldLink = contentType.FieldLinks[field.Id];
    if (fieldLink == null) // No, so add it.
    {
        fieldLink = new SPFieldLink(field);
        contentType.FieldLinks.Add(fieldLink);
    }
    return fieldLink;
}