Cómo: Agregar o quitar entradas de la lista de inclusión

El programa de instalación de soluciones de Office puede agregar entradas a la lista de inclusión cuando la solución que se está instalando no tiene un certificado de confianza. El programa de instalación muestra un mensaje y los usuarios pueden responder e indicar que la solución debe ser de confianza. Si desea agregar la solución a la lista de inclusión del usuario sin que éste vea ningún mensaje, puede agregar una entrada a la lista de inclusión mediante programación. Para obtener información sobre las listas de inclusión, vea Otorgar confianza a las soluciones de Office mediante listas de inclusión.

Se aplica a: la información de este tema se aplica a los proyectos de nivel de documento y los proyectos de nivel de aplicación para Microsoft Office 2010 y 2007 Microsoft Office System. Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto de Office.

Los procedimientos siguientes utilizan aplicaciones de consola para modificar la lista de inclusión. Debe evitar modificar el código para aceptar los datos proporcionados por los usuarios.

Para obtener la versión en vídeo de este tema, vea Video How to: Add or Remove Inclusion List Entries.

Agregar entradas a la lista de inclusión

Agregue elementos AddInSecurityEntry a UserInclusionList mediante el método Add(AddInSecurityEntry).

Para agregar una solución a la lista de inclusión

1. Cree una aplicación de consola o una biblioteca de clases de Visual Basic o Visual C# que tenga como destino .NET Framework 3.5.

   Nota

   Si implementa una solución de Office mediante Windows Installer, puede instalar soluciones de Office en el directorio Archivos de programa y evitar tener que crear una entrada en la lista de inclusión.

2. Agregue una referencia a Microsoft.VisualStudio.Tools.Office.Runtime.v10.0.

3. Abra el archivo Module1.vb o Program.cs para modificarlo y agregue la siguiente instrucción Imports o using en la parte superior del archivo.

   Imports Microsoft.VisualStudio.Tools.Office.Runtime.Security
   

   using Microsoft.VisualStudio.Tools.Office.Runtime.Security;
   

4. Abra el manifiesto de implementación para la solución de Office que está agregando a la lista de inclusión y busque el elemento RSAKeyValue que aparece debajo del nodo StrongNameSignature.

5. Copie en el Portapapeles el elemento RSAKeyValue, junto con todos los elementos secundarios y las etiquetas RSAKeyValue.

6. Agregue el código siguiente al método Main y reemplace PublicKey con el texto copiado del manifiesto de implementación y el URI de ejemplo con la ubicación del manifiesto de implementación.

   Dim publicKey As String = "<RSAKeyValue><Modulus>mUl8MhOil1fKLKYpHItsyCGNXxGJW74L8d4zOVwSvLDP1qoXF0lLqf/Ql8yO+31zuFbx8Aer3eQz9tcb/pz0NJREdbeOvxYa+nHTnR3j7rRUkmE8AKzvcG8BmTlgbprXaY0QTln8syHTC7yY5AA+xibwatFMpEpEBRqF5MmsGkE=</Modulus><Exponent>AQAB</Exponent></RSAKeyValue>"
   Dim solutionLocation As New _
       Uri("http://DeploymentServer/MySolution/MySolution.vsto")
   Dim entry As AddInSecurityEntry
   
   Try
       entry = New AddInSecurityEntry(solutionLocation, publicKey)
       UserInclusionList.Add(entry)
   
   Catch e As ArgumentNullException
       Console.WriteLine(("Exception: " + e.Message))
   End Try
   

   string publicKey = "<RSAKeyValue><Modulus></Modulus><Exponent>AQAB</Exponent></RSAKeyValue>";
   Uri solutionLocation = new Uri(@"http://DeploymentServer/MySolution/MySolution.vsto");
   
   AddInSecurityEntry entry;
   
   try
   {
       entry = new AddInSecurityEntry(solutionLocation, publicKey);
       UserInclusionList.Add(entry);
   }
   
   catch (ArgumentNullException e)
   {
       Console.WriteLine("Exception: " + e.Message);
   }
   

7. Genere la aplicación.

8. Ejecute la aplicación en el equipo donde se está ejecutando la solución de Visual Studio Tools para Office. La solución con el manifiesto de implementación que está representada por solutionLocation se agregará a la lista de inclusión.

Quitar entradas de la lista de inclusión

Quite las entradas mediante el método Remove(Uri) de la clase UserInclusionList.

Para quitar una solución de la lista de inclusión

1. Cree una aplicación de consola o una biblioteca de clases de Visual Basic o Visual C# que tenga como destino .NET Framework 3.5.

2. Agregue una referencia a Microsoft.VisualStudio.Tools.Office.Runtime.v10.0.

3. Abra el archivo de código para modificarlo y agregue la siguiente instrucción Imports o using en la parte superior del archivo.

   Imports Microsoft.VisualStudio.Tools.Office.Runtime.Security
   

   using Microsoft.VisualStudio.Tools.Office.Runtime.Security;
   

4. Agregue el siguiente código al método Main y reemplace el URI de ejemplo con la ubicación del manifiesto de implementación.

   Dim solutionLocation As New _
       Uri("http://DeploymentServer/MySolution/MySolution.vsto")
   Try
       UserInclusionList.Remove(solutionLocation)
   
   Catch e As ArgumentNullException
       Console.WriteLine(("Exception: " + e.Message))
   End Try
   

   Uri solutionLocation = new Uri("http://DeploymentServer/MySolution/MySolution.vsto");
   
   try
   {
       UserInclusionList.Remove(solutionLocation);
   }
   
   catch (ArgumentNullException e)
   {
      Console.WriteLine("Exception: " + e.Message);
   }
   

5. Genere la aplicación.

6. Ejecute la aplicación en el equipo donde se está ejecutando la solución de Visual Studio Tools para Office. La solución con el manifiesto de implementación que está representada por solutionLocation se quitará de la lista de inclusión.

Vea también

Conceptos

Otorgar confianza a las soluciones de Office mediante listas de inclusión

Otros recursos

Asegurar las soluciones de Office