Elemento CustomAction (ação personalizada)

Define uma única ação personalizada para um link ou barra de ferramentas item.

                    
                      
<CustomAction
  ContentTypeId = "Text"
  ControlAssembly = "Text"
  ControlClass = "Text"
  ControlSrc = "Text"
  Description = "Text"
  GroupId = "Text"
  Id = "Text"
  ImageUrl = "Text"
  Location = "Text"
  RegistrationId = "Text"
  RegistrationType = "Text"
  RequireSiteAdministrator = "TRUE" | "FALSE"
  Rights = "Text"
  Sequence = "Integer"
  ShowInLists = "TRUE" | "FALSE"
  ShowInReadOnlyContentTypes = "TRUE" | "FALSE"
  ShowInSealedContentTypes = "TRUE" | "FALSE"
  Title = "Text">
</CustomAction>
                    

Atributos

Atributo	Descrição
ContentTypeId	Opcional Text. Especifica a identificação de uma tipo de conteúdo para associar com a ação personalizada.
ControlAssembly	Opcional Text. Especifica o assembly de um controle que ofereça suporte a ação personalizada.
ControlClass	Opcional Text. Especifica uma classe controle que ofereça suporte a ação personalizada.
ControlSrc	Opcional Text. Especifica a URL relativa do arquivo .ascx que serve como a origem para o ação personalizada, de exemplo, "~/_controltemplates/myCustomAction.ascx".
Description	Opcional Text. Especifica uma descrição mais longa para a ação que é exposta como uma dica de ferramenta ou sub-Description para a ação.
GroupId	Opcional Text. Identifica um GRUPO ação que contém a ação, de exemplo, "SiteManagement". Se contido em um GRUPO ação personalizada, o valor do atributo GroupId GroupId deve ser igual a GRUPO identificação do elemento 2ef32bbe-06b8-4bba-bba7-86e457579eaf CustomActionGroup. Consulte identificações Locais de ação personalizada e identificações de padrão wssnoversshort Windows SharePoint Services padrão locais da ação personalizada.
Id	Opcional Text. Especifica um identificador exclusivo para o ação personalizada. A identificação pode ser um GUID, ou pode ser um exclusivo termo, de exemplo, "HtmlViewer". Consulte identificações Locais de ação personalizada e identificações de padrão wssnoversshort Windows SharePoint Services padrão locais da ação personalizada.
ImageUrl	Opcional Text. Especifica um relativo servidor virtual link para uma imagem que apresenta um ícone para o item.
Location	Opcional Text. Especifica a localidade deste ação personalizada, de exemplo, "Microsoft.SharePoint.SiteSettings". If the custom action is a menu item or toolbar button, then the possible options include EditControlBlock, NewFormToolbar, DisplayFormToolbar, and EditFormToolbar. Se contido em um GRUPO ação personalizada, o valor do atributo Location local deve ser igual a localidade do elemento 2ef32bbe-06b8-4bba-bba7-86e457579eaf CustomActionGroup. Consulte identificações Locais de ação personalizada e identificações de padrão wssnoversshort Windows SharePoint Services padrão locais da ação personalizada.
RegistrationId	Opcional Text. Especifica o identificador de tipo de conteúdo a lista ou item que essa ação é associado com ou identificador programático ou tipo de arquivo ( ProgID).
RegistrationType	Opcional Text. Especifica o anexo registro para um por-ação item. Valores possíveis incluem: ContentType FileType List ProgId
RequireSiteAdministrator	Opcional Boolean. TRUE para especificar que o item ser exibidos somente se o usuário for um administrador site; FALSE. Usando o atributo RequireSiteAdministrator RequireSiteAdministrator para a drop-down menu de Windows SharePoint Services comandos associado com itens lista não é com suporte.
Rights	Opcional Text. Especifica um conjunto de direitos que o usuário deve ter em ordem para o link que devem ficar visíveis, de exemplo, "ViewListItems,ManageAlerts". Se não especificado, em seguida, a ação sempre aparecerá na lista de ações. Para especificar múltiplo direitos, separar os valores usando vírgulas. O conjunto de direitos são agrupados logicamente de acordo com AND lógica, que significa que um usuário deve ter todos os direitos especificados para ver uma ação. Para obter uma lista dos valores possíveis, consulte Microsoft.SharePoint.SPBasePermissions.
Sequence	Opcional Integer. Especifica a prioridade de classificação para ações.
ShowInReadOnlyContentTypes	Opcional Boolean. TRUE se o ação personalizada somente é exibida para de conteúdo READ-ONLY tipos sobre a página para gerenciar de conteúdo tipos. O valor usar como padrão é FALSE.
ShowInSealedContentTypes	Opcional Boolean. TRUE se o ação personalizada somente é exibida para tipos na página para gerenciar de conteúdo tipos. O valor usar como padrão é FALSE.
Title	Necessário Text. Especifica a descrição usuário final para esta ação.

Elementos filho

UrlAction

Elementos pai

Elementos

Ocorrências

No mínimo: 1 Máximo: Unbounded

Comentários

Você pode usar o elemento CustomAction CustomAction para padrão adicionar controles ASP.NET e controles de usuário (por exemplo, caixas de texto ou botões opção) como personalizado ações em barras de ferramentas. No entanto, você pode somente adicionar controles instantiating itens menu para os menus suspensos das barras de ferramentas; Não é possível adicionar Web Parts ou controles arbitrários.

Exemplo

Para obter um exemplo de como esse elemento é usado, consulte Definições de ação personalizada.

Consulte também

Conceitos

Locais de ação personalizada e identificações de padrão