Share via


Cómo: Registrar y administrar las extensiones de características

Puede agregar tipos personalizados y destinos para la refactorización, reglas para analizar el código de base de datos, condiciones para pruebas unitarias de base de datos y generadores de datos para aumentar la funcionalidad que ofrece Visual Studio Premium o Visual Studio Ultimate. Sin embargo, para poder usar una extensión de características, deberá registrarla primero, independientemente de si creó la extensión o instaló una creada por otro usuario. Para obtener más información, vea Extender las características de base de datos de Visual Studio.

Se recomienda crear una carpeta para las extensiones en la carpeta Archivos de programa\Microsoft Visual Studio 10.0\VSTSDB\Extensions. Este enfoque permite conceder permisos de escritura a la subcarpeta pero no a la carpeta Extensions. Los usuarios podrán agregar extensiones personalizadas pero no podrán cambiar accidentalmente los archivos que forman parte de Visual Studio.

Nota de precauciónPrecaución

Debe tener permisos de administrador en el equipo para poder crear una subcarpeta en la carpeta Archivos de programa\Microsoft Visual Studio 10.0\VSTSDB\. Si no tiene los permisos adecuados, póngase en contacto con el administrador de red.

Consideraciones de seguridad

Si va a instalar una extensión creada por otra persona, debe tener en cuenta los siguientes riesgos:

  • El programa de instalación de la extensión podría ser malintencionado y obtener acceso a los recursos protegidos basándose en sus permisos de instalación.

  • La propia extensión podría ser malintencionada y hacerse con el control de los recursos protegidos si el usuario que utiliza la extensión tiene los permisos necesarios.

Para minimizar los riesgos, instale la extensión únicamente si procede de un origen conocido. Si obtiene la extensión de un origen que no es de confianza, inspeccione el código fuente de esa extensión y su programa de instalación (si lo tiene) antes de instalar y usar la extensión.

Para instalar una extensión de características personalizada

  • Copie el ensamblado firmado (.dll) en la carpeta Archivos de programa\Microsoft Visual Studio 10.0\VSTSDB\Extensions\extensionesPersonalizadas.

    extensionesPersonalizadas es el nombre de la carpeta creada por el usuario o el administrador de equipo para los ensamblados y archivos XML de las extensiones de características.

    Nota

    Se recomienda no copiar los ensamblados y archivos XML directamente en la carpeta Archivos de programa\Microsoft Visual Studio 10.0\VSTSDB\Extensions. Si utiliza una subcarpeta, evitará que se produzcan cambios accidentales en los archivos proporcionados con Visual Studio.

    A continuación, deberá registrar la extensión para que aparezca en Visual Studio.

Para registrar una extensión de características

  1. En el menú Ver, haga clic en Otras ventanas y, a continuación, haga clic en Ventana Comandos.

  2. En la ventana Comandos, escriba el código siguiente y reemplace FilePath por la ruta de acceso y el nombre de archivo del ensamblado. Escriba la ruta de acceso y el nombre de archivo entre comillas.

    Nota

    Si creó una extensión, la ruta de acceso predeterminada del archivo .dll compilado es rutaDeAccesoDeSolución\bin\Debug o rutaDeAccesoDeSolución\bin\Release.

    ? System.Reflection.Assembly.LoadFrom("FilePath").FullName
    
    ? System.Reflection.Assembly.LoadFrom(@"FilePath").FullName
    
  3. Presione Entrar.

  4. Copie la línea resultante al Portapapeles. Debe ser similar a la siguiente:

    "GeneratorAssembly, Version=1.0.0.0, Culture=neutral, PublicKeyToken=nnnnnnnnnnnnnnnn"
    
  5. Abra un editor de texto sin formato, como el Bloc de notas.

  6. Proporcione la siguiente información, especificando el nombre del ensamblado, el símbolo de clave pública y el tipo de extensión:

    <?xml version="1.0" encoding="utf-8" ?>
    <extensions assembly=""
                version="1" xmlns="urn:Microsoft.Data.Schema.Extensions"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                xsi:schemaLocation="urn:Microsoft.Data.Schema.Extensions Microsoft.Data.Schema.Extensions.xsd">
      <extension type="<enter extension type here>" assembly="<enter assembly name here>, Version=1.0.0.0, Culture=neutral, PublicKeyToken=b4deb9b383d021b0" enabled="true"/>
    </extensions>
    

    La extensión es de la forma "espacio_nombres.nombre_clase". El nombre de ensamblado no incluye la extensión .dll.

    SugerenciaSugerencia

    El archivo puede contener una lista de tipos de extensión si el ensamblado tiene varias clases.

  7. Guarde el archivo con la extensión .Extensions .xml.

    Por ejemplo, asigne al archivo el nombre nombreDeCondiciónDePrueba.Extensions.xml.

  8. Agregue este archivo a la carpeta Archivos de programa\Microsoft Visual Studio 10.0\VSTSDB\Extensions\extensionesPersonalizadas.

    extensionesPersonalizadas es el nombre de la carpeta creada por el usuario o el administrador de equipo para los ensamblados y archivos XML de las extensiones de características.

    Nota

    Se recomienda no copiar los ensamblados y archivos XML directamente en la carpeta Archivos de programa\Microsoft Visual Studio 10.0\VSTSDB\Extensions. Si utiliza una subcarpeta, evitará que se produzcan cambios accidentales en los archivos proporcionados con Visual Studio.

  9. Cierre y abra de nuevo Visual Studio.

    La extensión estará disponible.

Ejemplo

En el ejemplo siguiente, se muestra el archivo XML necesario para registrar la regla personalizada de análisis de código de base de datos que se crea en Tutorial: Crear un ensamblado de regla de análisis de código estático personalizada para SQL. Debe sustituir la clave pública y el nombre del ensamblado del ejemplo por los que correspondan. El nombre del ensamblado del ejemplo siguiente es "SampleRules".

<?xml version="1.0" encoding="utf-8"?>
<extensions assembly=""
            version="1" xmlns="urn:Microsoft.Data.Schema.Extensions"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:schemaLocation="urn:Microsoft.Data.Schema.Extensions Microsoft.Data.Schema.Extensions.xsd">
  <extension type="SampleRules.AvoidWaitForDelayRule" assembly="SampleRules, Version=1.0.0.0, Culture=neutral, PublicKeyToken=b4deb9b383d021b0" enabled="true"/>
</extensions>

Vea también

Conceptos

Definir condiciones personalizadas para pruebas unitarias de base de datos

Generar datos de pruebas especializados con un generador de datos personalizado

Crear tipos de refactorización de base de datos personalizados o destinos

Crear y registrar reglas adicionales para analizar el código de base de datos