Метод SPFieldCollection.AddLookup (String, Guid, Guid, Boolean)

Статья
05/13/2015

Создает поле подстановок в коллекции полей для одного списка, указывающего поля в коллекции для другого списка в другой веб-узел.

Пространство имен: Microsoft.SharePoint
Сборка: Microsoft.SharePoint (в Microsoft.SharePoint.dll)

Синтаксис

'Декларация
Public Function AddLookup ( _
    displayName As String, _
    lookupListId As Guid, _
    lookupWebId As Guid, _
    bRequired As Boolean _
) As String
'Применение
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
)

Параметры

displayName
Тип: System.String

Строка, указывающая отображаемое имя поля.

lookupListId
Тип: System.Guid

Объект System.Guid , который задает целевой список для поля подстановок.

lookupWebId
Тип: System.Guid

Объект System.Guid , который задает целевой веб-сайт для поля подстановок.

bRequired
Тип: System.Boolean

true , если поле является обязательным для хранения значений; в противном случае — false.

Возвращаемое значение

Тип: System.String
Строка, содержащая внутреннее имя, которое используется для данного поля. Новое поле можно получить, передав это значение в метод GetFieldByInternalName(String) . Поле, которое возвращается имеет тип SPFieldLookup.

Замечания

Этот метод создает поле типа SPFieldLookup в коллекцию текущего списка полей. Поле подстановок в один список получает значение из поля в другом списке целевого списка, указанного в параметре lookupListId . После добавления поля подстановок в коллекции, следует извлечь их из коллекции и затем определить поле источника в целевой список с помощью свойства LookupField .

Известно целевой список, который является источником значения поля подстановки для поля подстановки; поле подстановки, можно обнаружить, анализ объектов в коллекции, возвращаемой методом GetRelatedFields() в целевой список.

Текущий пользователь должен иметь SPBasePermissions.ManageLists разрешение на целевой список, при вызове этого метода.