(String, Guid, Guid, Boolean) del método SPFieldCollection.AddLookup

Artículo
05/13/2015

Crea un campo de búsqueda en la colección de campos de una lista que señala a un campo de la colección de otra lista en un sitio Web diferente.

Espacio de nombres: Microsoft.SharePoint
Ensamblado: Microsoft.SharePoint (en Microsoft.SharePoint.dll)

Sintaxis

'Declaración
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
Tipo: System.String

Una cadena que especifica el nombre para mostrar del campo.

lookupListId
Tipo: System.Guid

Un objeto System.Guid que especifica la lista de objetivo del campo de búsqueda.

lookupWebId
Tipo: System.Guid

Un objeto System.Guid que especifica el sitio Web de destino para el campo de búsqueda.

bRequired
Tipo: System.Boolean

true si el campo es necesario para contener valores; en caso contrario, false.

Valor devuelto

Tipo: System.String
Una cadena que contiene el nombre interno que se usa para el campo. Puede recuperar el nuevo campo pasando este valor al método GetFieldByInternalName(String) . El campo que se devuelve es del tipo SPFieldLookup.

Comentarios

Este método crea un campo de tipo SPFieldLookup en la colección de campos de la lista actual. Un campo de búsqueda en una lista toma su valor de un campo de otra lista, la lista de destino especificada en el parámetro lookupListId . Después de agregar un campo de búsqueda a la colección, debe recuperar desde la colección y, a continuación, identifique el campo de origen en la lista destino estableciendo la propiedad LookupField .

La lista de destino que es el origen del valor del campo de búsqueda es consciente del campo de búsqueda; es decir, puede detectar el campo de búsqueda mediante el examen de los objetos de la colección devuelta por el método GetRelatedFields() de la lista de destino.

El usuario actual debe tener SPBasePermissions.permiso de ManageLists en la lista de destino cuando se llama a este método.