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, |
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, 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, |
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, 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:
|
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, |
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
Elementos primarios
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