SPFieldCollection.AddLookup method (String, Guid, Guid, Boolean)

Artigo
05/12/2015

Cria um campo de pesquisa na coleção de campos de uma lista que aponta para um campo no conjunto de outra lista em um site diferente.

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

Syntax

'Declaração
Public Function AddLookup ( _
    displayName As String, _
    lookupListId As Guid, _
    lookupWebId As Guid, _
    bRequired As Boolean _
) As String
'Uso
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
)

Parâmetros

displayName
Type: System.String

Uma seqüência de caracteres que especifica o nome de exibição do campo.

lookupListId
Type: System.Guid

Um objeto de System.Guid que especifica a lista de destino para o campo de pesquisa.

lookupWebId
Type: System.Guid

Um objeto de System.Guid que especifica o site de destino para o campo de pesquisa.

bRequired
Type: System.Boolean

true se o campo é obrigatório para conter valores; Caso contrário, false.

Valor retornado

Type: System.String
Uma seqüência de caracteres que contém o nome interno é usado para o campo. Você pode recuperar o novo campo, passar esse valor para o método GetFieldByInternalName(String) . O campo que é retornado é do tipo SPFieldLookup.

Comentários

Esse método cria um campo do tipo SPFieldLookup na coleção de campo da lista. Um campo de pesquisa em uma lista leva seu valor de um campo em outra lista, a lista de destino especificada no parâmetro lookupListId . Depois de adicionar um campo de pesquisa à coleção, deverá recuperá-lo da coleção e, em seguida, identificar o campo de origem na lista target, definindo a propriedade LookupField .

A lista de destino é a fonte do valor do campo de pesquisa está ciente do campo de pesquisa; ou seja, você pode descobrir o campo de pesquisa, examinando os objetos na coleção retornada pelo método de GetRelatedFields() da lista de destino.

O usuário atual deve ter SPBasePermissions.permissão de ManageLists da lista de destino quando você chamar esse método.