SPFieldCollection.AddLookup 方法 (String, Guid, Guid, Boolean)

指向集合中的另一个不同的网站中的列表的字段的一个列表的字段集合中创建查阅字段。

命名空间：  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在调用此方法时，目标列表上的权限。

另请参阅

引用

SPFieldCollection 类

SPFieldCollection 成员

AddLookup 重载

Microsoft.SharePoint 命名空间

SPFieldLookup

LookupField

GetFieldByInternalName(String)

AddDependentLookup(String, Guid)

GetRelatedFields()