Compartilhar via


Definições de ação personalizada

Ação personalizada arquivos estão incluídos como parte dos recursos e são implantados como descrições elemento XML. Um arquivo ação personalizada está estruturado com um elemento cc5ed5c2-c362-4a61-af77-ff9e8f7e1cae CustomAction, que serve como a definição núcleo para um único ação personalizada de um link ou barra de ferramentas item.

Elementos

  CustomActionGroup

  HideCustomAction

  CustomAction

    UrlAction

Exemplo

O seguinte exemplo define um arquivo ação personalizada que você pode unir no arquivo .WSP de uma solução.

                    <Elements xmlns="https://schemas.microsoft.com/sharepoint/">
  <CustomActionGroup 
    Id="VirtualServerConfiguration"
   Location="Microsoft.SharePoint.Administration.ApplicationManagement"
    Title="Virtual Server Configuration"
    Sequence="10"
    ImageUrl ="/images/listset.gif"
    Description="Use these links to install Windows SharePoint Services on a new virtual server, configure settings across all sites on a virtual server, or create a new top-level Web site. "/>
  <CustomAction 
    Id="Extend"
   Location="Microsoft.SharePoint.Administration.ApplicationManagement"
    Sequence="10" 
    Title="Extend or upgrade virtual server" 
    Description="">
    <UrlAction Url="vslist.aspx?NextPage=extendvsoption.aspx&amp;Show=NeedExtend&amp;Show=NeedUpgrade"/>
  </CustomAction>
  <CustomAction 
    Id="CreateSite"
   Location="Microsoft.SharePoint.Administration.ApplicationManagement"
    Sequence="20" 
    Title="Create a top-level Web site" 
    Description="">
    <UrlAction Url="vslist.aspx?NextPage=createsite.aspx&amp;Show=Ready"/>
  </CustomAction>
  <CustomAction 
    Id="DeleteSite"
   Location="Microsoft.SharePoint.Administration.ApplicationManagement"
    Sequence="30" 
    Title="Delete site collection" 
    Description="">
    <UrlAction Url="delsite.aspx"/>
  </CustomAction>
  <CustomAction 
    Id="ConfigureVirtualServer"
   Location="Microsoft.SharePoint.Administration.ApplicationManagement"
    Sequence="40" 
    Title="Configure virtual server settings" 
    Description="">
    <UrlAction Url="vslist.aspx?NextPage=vssettings.aspx"/>
  </CustomAction>
</Elements>

O elemento 2ef32bbe-06b8-4bba-bba7-86e457579eaf CustomActionGroup contém a definição núcleo para um agrupamento de personalizado ações.

O elemento eb7a0573-bd6b-4946-a319-c24905859662 UrlAction deve ser usado para especificar o URL para um ação personalizada. Se nenhuma ação é especificada (uma condição de erro), o link é exibido mas ele não está vinculado a qualquer coisa.

Use o elemento afa42678-945d-4d8c-a5b3-8a1ca37831d1 HideCustomAction para ocultar uma ação existente que esteja implementado Por padrão dentro da infra-estrutura de wssnoversshort Windows SharePoint Services recursos, ou em outro ação personalizada. Para uma lista de ação personalizada o usar como padrão as identificações, Consulte identificações Locais de ação personalizada e identificações de padrão padrão locais da ação personalizada.

O próximo exemplo mostra um arquivo XML cujas ações usar como padrão substituir o conteúdo em uma página Windows SharePoint Services wssnoversshort com novas ações. Para uma tarefa programação que mostra as etapas para definir e registrando personalizado ações, consulte Como a: Adicionar Ações para a interface do usuário.

                    <Elements xmlns="https://schemas.microsoft.com/sharepoint/">
   <CustomActionGroup 
      Id="PortalAnalytics"
   Location="Microsoft.SharePoint.Administration.ApplicationManagement"
      Title="Usage Reporting"
      Sequence="50" />
   <CustomAction 
      Id="ManageAnalytics"
      GroupId="PortalAnalytics"
   Location="Microsoft.SharePoint.Administration.ApplicationManagement"
      Sequence="10" 
      Title="Configure usage reporting" >
      <UrlAction 
         Url="_layouts/SpUsageConfig.aspx"/>
   </CustomAction>
   <HideCustomAction
      Id="HideWssSiteCollectionUsage"
      HideActionId="SiteCollectionUsage"
      GroupId="SiteCollectionAdmin"
      Location="Microsoft.SharePoint.SiteSettings" />
   <HideCustomAction
      Id="HideWssWebUsage"
      HideActionId="WebUsage"
      GroupId="SiteAdministration"
      Location="Microsoft.SharePoint.SiteSettings" />
   <CustomAction
      Id="PortalSiteUsage"
      GroupId="SiteCollectionAdmin"
      Location="Microsoft.SharePoint.SiteSettings"
      Rights="ViewUsageData"
      Sequence="30"
      Title="Site usage data">
      <UrlAction
         Url="_layouts/SpUsageSite.aspx" />
   </CustomAction>
   <CustomAction
      Id="PortalWebUsage"
      GroupId="SiteAdministration"
      Location="Microsoft.SharePoint.SiteSettings"
      Rights="ViewUsageData"
      Sequence="30"
      Title="Web usage data">
      <UrlAction
         Url="_layouts/SpUsageWeb.aspx" />
   </CustomAction>
</Elements>

Consulte também

Conceitos

Ação personalizada
Locais de ação personalizada e identificações de padrão
Como a: Adicionar Ações para a interface do usuário