Elemento CustomAction (Acción personalizada)

Define una única acción personalizada para un elemento de vínculo o de barra de herramientas.

<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	Descripción
ContentTypeId	Text opcional. Especifica el identificador de un tipo de contenido que se va a asociar con la acción personalizada.
ControlAssembly	Text opcional. Especifica el ensamblado de un control que admite la acción personalizada.
ControlClass	Text opcional. Especifica una clase de control que admite la acción personalizada.
ControlSrc	Text opcional. Especifica la dirección URL relativa del archivo .ascx que funciona como origen para la acción personalizada (por ejemplo, "~/_controltemplates/myCustomAction.ascx").
Description	Text opcional. Especifica una descripción más larga para la acción que se expone como una información sobre herramientas o subdescripción de la acción.
GroupId	Text opcional. Identifica un grupo de acción que contiene la acción como, por ejemplo, "SiteManagement". Si se encuentra dentro de un grupo de acciones personalizadas, el valor del atributo GroupId debe ser igual que el identificador de grupo del elemento CustomActionGroup. Consulte Ubicaciones e identificadores de acciones personalizadas predeterminadas para obtener una lista de los identificadores de grupos de acciones personalizadas predeterminadas que se utilizan en Windows SharePoint Services.
Id	Text opcional. Especifica un identificador único para la acción personalizada. El identificador puede ser un GUID o puede ser un término único como, por ejemplo, "HtmlViewer". Consulte Ubicaciones e identificadores de acciones personalizadas predeterminadas para obtener una lista de los identificadores de acciones personalizadas predeterminadas que se utilizan en Windows SharePoint Services.
ImageUrl	Text opcional. Especifica un vínculo relativo al servidor virtual a una imagen que presenta un icono para el elemento.
Location	Text opcional. Especifica la ubicación de esta acción personalizada, por ejemplo, "Microsoft.SharePoint.SiteSettings". Si la acción personalizada es un elemento de menú o un botón de una barra de herramientas, las opciones son EditControlBlock, NewFormToolbar, DisplayFormToolbar y EditFormToolbar. Si se encuentra dentro de un grupo de acciones personalizadas, el valor del atributo Location debe ser igual que la ubicación del elemento CustomActionGroup. Consulte Ubicaciones e identificadores de acciones personalizadas predeterminadas para obtener una lista de las ubicaciones de acciones personalizadas predeterminadas que se utilizan en Windows SharePoint Services.
RegistrationId	Text opcional. Especifica el identificador del tipo de contenido de lista o elemento al que está asociada esta acción, o el tipo de archivo o identificador de programación (ProgID).
RegistrationType	Text opcional. Especifica el archivo adjunto de registro para una acción por elemento. Entre los valores posibles se incluyen: ContentType FileType List ProgId
RequireSiteAdministrator	Boolean opcional. Es TRUE para especificar que el elemento se muestra sólo si el usuario es un administrador de sitio; de lo contrario, es FALSE. No se admite el uso del atributo RequireSiteAdministrator para el menú desplegable de comandos de Windows SharePoint Services asociados con elementos de lista.
Rights	Text opcional. Especifica un conjunto de derechos que el usuario debe tener para que el vínculo sea visible, por ejemplo, "ViewListItems,ManageAlerts". Si no se especifica, la acción siempre aparecerá en la lista de acciones. Para especificar varios derechos, separe los valores mediante comas. El conjunto de derechos se agrupa de forma lógica conforme a la lógica AND, lo que significa que el usuario debe tener todos los derechos especificados para ver una acción. Para obtener una lista de los valores posibles, consulte Microsoft.SharePoint.SPBasePermissions.
Sequence	Integer opcional. Especifica la prioridad de ordenación para las acciones.
ShowInReadOnlyContentTypes	Boolean opcional. TRUE si la acción personalizada sólo se muestra para tipos de contenido de sólo lectura en la página de administración de tipos de contenido. El valor predeterminado es FALSE.
ShowInSealedContentTypes	Boolean opcional. TRUE si la acción personalizada sólo se muestra para tipos de contenido sellado en la página de administración de tipos de contenido. El valor predeterminado es FALSE.
Title	Text obligatorio. Especifica la descripción del usuario final para esta acción.

Elementos secundarios

UrlAction

Elementos primarios

Elements

Repeticiones

Mínimo: 1 Máximo: sin límite

Comentarios

Puede usar el elemento CustomAction para agregar controles ASP.NET estándar y controles de usuario (por ejemplo, cuadros de texto o botones de opción) como acciones personalizadas de las barras de herramientas. Sin embargo, sólo se pueden agregar controles que creen instancias de elementos de menú a los menús desplegables de las barras de herramientas; no se pueden agregar elementos web o controles arbitrarios.

Ejemplo

Para obtener un ejemplo de cómo se usa este elemento, consulte Definiciones de acción personalizada.

Vea también

Otros recursos

Ubicaciones e identificadores de acciones personalizadas predeterminadas