SPFieldCollection.AddLookup-Methode (String, Guid, Guid, Boolean)

Artikel
05/06/2015

Erstellt ein Nachschlagefeld in der Auflistung der Felder für eine Liste, verweist auf ein Feld in der Auflistung für eine andere Liste in einer anderen Website.

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

Syntax

'Declaration
Public Function AddLookup ( _
    displayName As String, _
    lookupListId As Guid, _
    lookupWebId As Guid, _
    bRequired As Boolean _
) As String
'Usage
Dim instance As SPFieldCollection
Dim displayName As String
Dim lookupListId As Guid
Dim lookupWebId As Guid
Dim bRequired As Boolean
Dim returnValue As String

returnValue = instance.AddLookup(displayName, _
    lookupListId, lookupWebId, bRequired)

public string AddLookup(
    string displayName,
    Guid lookupListId,
    Guid lookupWebId,
    bool bRequired
)

Parameter

displayName
Typ: System.String

Eine Zeichenfolge, die den Anzeigenamen des Felds angibt.

lookupListId
Typ: System.Guid

Ein System.Guid -Objekt, für das Nachschlagefeld die Zielliste angibt.

lookupWebId
Typ: System.Guid

Ein System.Guid -Objekt, das die Ziel-Website für das Nachschlagefeld angibt.

bRequired
Typ: System.Boolean

true Wenn das Feld erforderlich ist, Werte enthalten; andernfalls false.

Rückgabewert

Typ: System.String
Eine Zeichenfolge, die den internen Namen enthält, der für das Feld verwendet wird. Sie können das neue Feld übergeben dieses Werts an die GetFieldByInternalName(String) -Methode abrufen. Das Feld, das zurückgegeben wird ist vom Typ SPFieldLookup.

Hinweise

Diese Methode erstellt ein Feld vom Typ SPFieldLookup in der aktuellen Liste Sammlung von Feldern. Ein Nachschlagefeld in einer einzigen Liste übernimmt seinen Wert aus einem Feld in einer anderen Liste die Zielliste in der lookupListId -Parameter angegeben. Nach dem Hinzufügen eines Nachschlagefelds zu der Auflistung sollten Sie aus der Auflistung abrufen und dann das Quellfeld in der Zielliste identifizieren, indem Sie die LookupField -Eigenschaft.

Die Zielliste, die Quelle für das Nachschlagefeld Wert beachtet das Nachschlagefeld; Das heißt, erkennen Sie das Nachschlagefeld durch die Objekte in der Auflistung der Zielliste GetRelatedFields() -Methode zurückgegebene untersuchen.

Der aktuelle Benutzer muss SPBasePermissionshaben.ManageLists -Berechtigung für die Zielliste, wenn Sie diese Methode aufrufen.