de la propiedad SPFieldLookup.LookupList
Obtiene o establece la representación de cadena del GUID que identifica la lista que es el origen del valor de este campo.
Espacio de nombres: Microsoft.SharePoint
Ensamblado: Microsoft.SharePoint (en Microsoft.SharePoint.dll)
Sintaxis
'Declaración
Public Property LookupList As String
Get
Set
'Uso
Dim instance As SPFieldLookup
Dim value As String
value = instance.LookupList
instance.LookupList = value
public string LookupList { get; set; }
Valor de propiedad
Tipo: System.String
La representación de cadena del GUID que identifica la lista que es el origen de la información para el campo. Si el campo no apunta a una lista, se devuelve una cadena vacía.
Excepciones
Excepción | Condición |
---|---|
SPException | Ya se ha establecido la propiedad. No puede cambiar la lista de búsqueda después de establecer la propiedad LookupList . |
Comentarios
Esta propiedad devuelve la representación de cadena de propiedad ID de la lista de origen. La propiedad LookupList se establece automáticamente cuando se crea un objeto SPFieldLookup llamando al método AddLookup o AddDependentLookup del objeto SPFieldCollection que representa la colección de campos de la lista donde desea agregar la columna de búsqueda.
Importante
Una vez establecida una columna de búsqueda, no se puede cambiar la lista de destino.
Ejemplos
En el siguiente ejemplo es una aplicación de consola que enumera los campos asociados a una lista, busca los campos de tipo SPFieldLookup. Cuando encuentra un campo de ese tipo, la aplicación usa el valor de la propiedad LookupList para obtener una referencia a la lista de los puntos del campo de búsqueda a y a continuación, en el valor de la propiedad LookupField para obtener el campo en el destino de lista que el campo de búsqueda apunta al.
using System;
using Microsoft.SharePoint;
namespace ConsoleApp
{
class Program
{
static void Main(string[] args)
{
using (SPSite siteCollection = new SPSite("https://localhost"))
{
using (SPWeb site = siteCollection.OpenWeb())
{
SPList list = site.Lists["Pending Orders"];
foreach (SPField item in list.Fields)
{
if (item is SPFieldLookup)
{
SPFieldLookup field = (SPFieldLookup)item;
if (!String.IsNullOrEmpty(field.LookupList) && !String.IsNullOrEmpty(field.LookupField))
{
// Is this the primary or secondary field for a list relationship?
string strRelationship = field.IsRelationship ? "Primary":"Secondary";
// Print the display name of the field.
Console.WriteLine("\nField: {0} ({1} Field)", field.Title, strRelationship);
// Is this a secondary field in a list relationship?
if (field.IsDependentLookup)
{
SPField primaryField = list.Fields[new Guid(field.PrimaryFieldId)];
Console.WriteLine("Primary Field: {0}", primaryField.Title);
}
// Get the site where the target list is located.
using (SPWeb targetSite = siteCollection.AllWebs[field.LookupWebId])
{
// Get the name of the list where this field gets information.
SPList targetList = targetSite.Lists[new Guid(field.LookupList)];
Console.WriteLine("Related list: {0}", targetList.Title);
// Get the name of the field where this field gets information.
SPField targetField = targetList.Fields.GetFieldByInternalName(field.LookupField);
Console.WriteLine("Related field: {0}", targetField.Title);
}
}
}
}
}
}
Console.Write("\nPress ENTER to continue...");
Console.ReadLine();
}
}
}
Imports System
Imports Microsoft.SharePoint
Module ConsoleApp
Sub Main()
Using siteCollection As New SPSite("https://localhost")
Using site As SPWeb = siteCollection.OpenWeb()
Dim list As SPList = site.Lists("Pending Orders")
For Each item As SPField In list.Fields
If TypeOf item Is SPFieldLookup Then
Dim field As SPFieldLookup = DirectCast(item, SPFieldLookup)
If Not String.IsNullOrEmpty(field.LookupList) AndAlso Not String.IsNullOrEmpty(field.LookupField) Then
' Is this the primary or secondary field for a list relationship?
Dim strRelationship As String = If(field.IsRelationship, "Primary", "Secondary")
' Print the display name of the field.
Console.WriteLine(vbLf & "Field: {0} ({1} Field)", field.Title, strRelationship)
' Is this a secondary field in a list relationship?
If field.IsDependentLookup Then
Dim primaryField As SPField = list.Fields(New Guid(field.PrimaryFieldId))
Console.WriteLine("Primary Field: {0}", primaryField.Title)
End If
' Get the site where the target list is located.
Using targetSite As SPWeb = siteCollection.AllWebs(field.LookupWebId)
' Get the name of the list where this field gets information.
Dim targetList As SPList = targetSite.Lists(New Guid(field.LookupList))
Console.WriteLine("Related list: {0}", targetList.Title)
' Get the name of the field where this field gets information.
Dim targetField As SPField = targetList.Fields.GetFieldByInternalName(field.LookupField)
Console.WriteLine("Related field: {0}", targetField.Title)
End Using
End If
End If
Next
End Using
End Using
Console.Write(vbLf & "Press ENTER to continue...")
Console.ReadLine()
End Sub
End Module
Vea también
Referencia
Espacio de nombres Microsoft.SharePoint