SPFieldLookup.RelationshipDeleteBehavior property

Artigo
05/12/2015

Obtém ou define o comportamento de exclusão do campo de pesquisa.

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

Syntax

'Declaração
Public Property RelationshipDeleteBehavior As SPRelationshipDeleteBehavior
    Get
    Set
'Uso
Dim instance As SPFieldLookup
Dim value As SPRelationshipDeleteBehavior

value = instance.RelationshipDeleteBehavior

instance.RelationshipDeleteBehavior = value

public SPRelationshipDeleteBehavior RelationshipDeleteBehavior { get; set; }

Property value

Type: Microsoft.SharePoint.SPRelationshipDeleteBehavior
O comportamento de exclusão. Os valores possíveis incluem Cascade, Restrict e None.

Exceptions

Exception	Condition
SPException	Você não pode definir um valor diferente de None , se o campo de pesquisa representa uma coluna de site.

Comentários

A propriedade de RelationshipDeleteBehavior permite que você impor integridade referencial da relação entre duas listas de uma lista depende de outra lista. Se um campo de pesquisa na lista dependente tem a propriedade de RelationshipDeleteBehavior definida como Cascade, em seguida, excluir um item da lista de origem faz com que todos os itens da lista de dependentes relacionados a ser excluída também. Por exemplo, suponha que você tenha uma lista de clientes está relacionada a uma lista de endereços por um campo de pesquisa na lista de endereços. Talvez você queira excluir um item de clientes para fazer com que todos os itens relacionados de endereços a serem excluídos também. Você poderia ser feito definindo a propriedade RelationshipDeleteBehavior do campo de pesquisa na lista de endereços para Cascade.

Definindo a propriedade RelationshipDeleteBehavior como Restrict impede que um item da lista de origem sejam excluídos se pesquisar todos os itens na lista de dependentes para ele. Por exemplo, suponha que sua lista de clientes é a fonte de um campo de pesquisa na lista de pedidos pendentes. Talvez você não queira um item da lista de clientes para ser excluído se o cliente tiver pedidos pendentes. Nesse caso, você poderia definir a propriedade de RelationshipDeleteBehavior para o campo de pesquisa em pedidos pendentes para Restrict.

Um campo de pesquisa que impõe uma restrição de exclusão deve ser indexado. Antes de definir a propriedade RelationshipDeleteBehavior para Cascade ou Restrict, defina a propriedade Indexed para true.

Importante

O usuário deve ter permissão de ManageLists na lista de fonte para especificar o Cascade ou Restrict. Para obter mais informações, consulte a enumeração SPBasePermissions .

Além disso, você não pode especificar uma restrição de exclusão se:

O campo de pesquisa permite que vários valores.

Antes de definir a propriedade RelationshipDeleteBehavior , certifique-se de que a propriedade AllowMultipleValues retorna false.
O campo de pesquisa aponta para uma lista no outro site.

Verifique o valor da propriedade de LookupWebId do campo de pesquisa.
O número de itens na lista excede o máximo definido para listas grandes.

Compare o valor retornado pela propriedade de ItemCount da lista com o valor retornado pela propriedade de MaxItemsPerThrottledOperation do aplicativo da Web.

O usuário atual deve ter SPBasePermissions.permissão de ManageLists da lista de destino quando essa propriedade é definida como Restrict.

Examples

O exemplo a seguir é um aplicativo de console que cria um vínculo entre duas listas, os clientes e pedidos pendentes. As listas são vinculadas usando o campo ID da lista de clientes como a origem para um novo campo de ID de cliente na lista de pedidos pendentes. Para impedir que um item de lista de clientes seja excluído se ele tiver quaisquer itens de lista de pedidos pendentes procurando até, a propriedade RelationshipDeleteBehavior do novo campo Identificação do cliente é definida como Restrict.

using System;
using Microsoft.SharePoint;

namespace RelatedLists
{
    class Program
    {
        static void Main(string[] args)
        {
            using (SPSite siteCollection = new SPSite("https://localhost"))
            {
                using (SPWeb site = siteCollection.OpenWeb())
                {
                    SPList lookupList = site.Lists.TryGetList("Customers");
                    SPList relatedList = site.Lists.TryGetList("Pending Orders");

                    if (lookupList != null && relatedList != null)
                    {
                        string strPrimaryCol = relatedList.Fields.AddLookup("Customer ID", lookupList.ID, true);
                        SPFieldLookup primaryCol = (SPFieldLookup)relatedList.Fields.GetFieldByInternalName(strPrimaryCol);

                        primaryCol.LookupField = lookupList.Fields["ID"].InternalName;
                        primaryCol.Indexed = true;
                        primaryCol.RelationshipDeleteBehavior = SPRelationshipDeleteBehavior.Restrict;
                        primaryCol.Update();
                    }
                }
            }
            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 lookupList As SPList = site.Lists.TryGetList("Customers")
                Dim relatedList As SPList = site.Lists.TryGetList("Pending Orders")

                If lookupList IsNot Nothing AndAlso relatedList IsNot Nothing Then
                    Dim strPrimaryCol As String = relatedList.Fields.AddLookup("Customer ID", lookupList.ID, True)
                    Dim primaryCol As SPFieldLookup = _
                        DirectCast(relatedList.Fields.GetFieldByInternalName(strPrimaryCol), SPFieldLookup)

                    primaryCol.LookupField = lookupList.Fields("ID").InternalName
                    primaryCol.Indexed = True
                    primaryCol.RelationshipDeleteBehavior = SPRelationshipDeleteBehavior.Restrict
                    primaryCol.Update()
                End If
            End Using
        End Using
        Console.Write(vbLf & "Press ENTER to continue...")
        Console.ReadLine()
    End Sub
End Module