FieldLookup.RelationshipDeleteBehavior propriedade
Obtém ou define um valor que especifica o comportamento de exclusão do campo de pesquisa.
Namespace: Microsoft.SharePoint.Client
Assemblies: Microsoft.SharePoint.Client.Silverlight (em Microsoft.SharePoint.Client.Silverlight.dll); Microsoft.SharePoint.Client.Phone (em Microsoft.SharePoint.Client.Phone.dll) Microsoft.SharePoint.Client (em Microsoft.SharePoint.Client.dll)
Sintaxe
'Declaração
Public Property RelationshipDeleteBehavior As RelationshipDeleteBehaviorType
Get
Set
'Uso
Dim instance As FieldLookup
Dim value As RelationshipDeleteBehaviorType
value = instance.RelationshipDeleteBehavior
instance.RelationshipDeleteBehavior = value
public RelationshipDeleteBehaviorType RelationshipDeleteBehavior { get; set; }
Valor de propriedade
Tipo: Microsoft.SharePoint.Client.RelationshipDeleteBehaviorType
Retorna uma instância de RelationshipDeleteBehaviorType que representa o comportamento de exclusão do campo de pesquisa.
Exceções
| Exceção | Condição |
|---|---|
| [Microsoft.SharePoint.SPException] | O servidor não permite que propriedades do campo a ser alterado. Código de erro:-2146232832. |
| [System.NotSupportedException] | A lista que o campo pertence é uma lista externa. Código de erro: -1. |
Comentários
A propriedade de RelationshipDeleteBehavior permite que você impor integridade referencial na relação entre duas listas quando uma única lista depende de outra lista. Se um campo de pesquisa na lista dependente tem a propriedade de RelationshipDeleteBehavior definida como Cascade, em seguida, excluindo um item da lista de origem faz com que todos os itens de lista dependentes relacionada a ser excluída também. Por exemplo, suponha que você tenha uma lista de clientes que 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 ser excluído também. Você pode realizar que definindo a propriedade RelationshipDeleteBehavior do campo de pesquisa na lista de endereços para Cascade.
Definindo a propriedade RelationshipDeleteBehavior para Restrict impede que um item da lista de origem sendo excluído se todos os itens na lista dependente procuram a ele. Por exemplo, suponha que sua lista de clientes é a fonte para um campo de pesquisa na lista de pedidos pendentes. Talvez você não queira um item na lista de clientes sejam excluídos 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, primeiro defina a propriedade Indexed() como true.
Importante
O usuário deve ter permissão de ManageLists na lista de origem para especificar Cascade ou Restrict. Para obter mais informações, consulte a enumeração BasePermissions .
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 de 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 BasePermissions. permissão de ManageLists na lista de destino quando essa propriedade é definida como Restrict.