SPFieldLinkCollection.Add-Methode

Artikel
05/06/2015

Fügt ein SPFieldLink -Objekt der Auflistung hinzu.

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

Syntax

'Declaration
Public Sub Add ( _
    fieldLink As SPFieldLink _
)
'Usage
Dim instance As SPFieldLinkCollection
Dim fieldLink As SPFieldLink

instance.Add(fieldLink)

public void Add(
    SPFieldLink fieldLink
)

Parameter

fieldLink
Typ: Microsoft.SharePoint.SPFieldLink

Verweis in der Auflistung hinzu. Das Argument sollte nicht Null sein.

Ausnahmen

Ausnahme	Bedingung
SPException	Der Wert der Name -Eigenschaft des Objekts, das Sie der Auflistung hinzugefügt werden müssen dupliziert den Wert der Name -Eigenschaft für ein Objekt, das bereits in der Auflistung vorhanden ist. -ODER- Das SPFieldLink -Objekt verweist auf ein Feld, das außerhalb des Gültigkeitsbereichs für diesen Inhaltstyp ist.

SPException

Der Wert der Name -Eigenschaft des Objekts, das Sie der Auflistung hinzugefügt werden müssen dupliziert den Wert der Name -Eigenschaft für ein Objekt, das bereits in der Auflistung vorhanden ist.

-ODER-

Das SPFieldLink -Objekt verweist auf ein Feld, das außerhalb des Gültigkeitsbereichs für diesen Inhaltstyp ist.

Hinweise

Objekte in der Auflistung sind durch den internen Namen (der Wert der Eigenschaft SPFieldLink.Name ) indiziert. Wenn Sie versuchen, ein Objekt hinzuzufügen, die den gleichen internen Namen als Objekt hat, die bereits in der Auflistung vorhanden ist, löst die Methode eine Ausnahme aus. Da der Wert der Eigenschaft SPFieldLink.Name die InternalName -Eigenschaft des SPField -Objekts identisch, die darauf verweist ist, wird diese Einschränkung effektiv sichergestellt, dass ein Inhaltstyp nicht im gleiche Feld zweimal verweisen kann.

Sie können nicht direkt ein Feld vom Typ SPFieldLookup hinzufügen, wenn es sich um eine sekundäre Nachschlagespalte ist (d. h., wenn die IsDependentLookup -Eigenschaft gibt truezurück). Wenn sekundäre Nachschlagefelder in eine Nachschlagespalte mit mehreren Spalten hinzufügen möchten, fügen Sie das primäre Nachschlagefeld (die IsDependentLookup -Eigenschaft gibt false) hinzu. Alle sekundären Nachschlagefelder, die auf dem primären Nachschlagefeld abhängig sind, werden automatisch hinzugefügt.

Beispiele

Das folgende Beispiel zeigt eine Methode, die überprüft, ob ein Inhaltstyp bereits eine Verknüpfung zu einem Feld besteht. Wenn dies nicht der Fall ist, wird die-Methode erstellt eine Verknüpfung und fügt es der Inhaltstyp-Auflistung hinzu.

Die Anwendung, die in diesem Beispiel werden importiert die System und Microsoft.Sharepoint -Namespace.

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;
}