Ejemplo LINQ Query Visualizer

Actualización: noviembre 2007

El visualizador de consultas es un ensamblado que se puede utilizar en una sesión de depuración de Visual Studio para visualizar las consultas de base de datos. El proyecto en sí es sólo una biblioteca, y no se ejecuta. Si se compila, se genera una biblioteca (DLL) que se puede utilizar en Visual Studio para mejorar la capacidad de depurar aplicaciones LINQ to SQL.

Nota:

Al depurar aplicaciones mediante el visualizador, quizás tenga que agregar Persist Security Info=true a la cadena de conexión. Cuando se activa el depurador, serializa la información del programa que se depura y la envía al proceso que muestra el visualizador. Una parte de la información que se serializa es la cadena de conexión que se obtiene del objeto SqlConnection. De forma predeterminada, el objeto SqlConnection no devuelve la contraseña y, por lo tanto, se serializa la cadena de conexión sin la contraseña y se envía al visualizador. Al intentar ejecutar la consulta en el visualizador, puede producirse un error, porque no tiene la contraseña. Utilice esta configuración sólo para la depuración. No la recomendamos para la producción.

Para obtener ejemplos e instrucciones para la instalación

• Siga uno o varios de los procedimientos siguientes:

  • En el menú Ayuda, haga clic en Ejemplos.

    El archivo Léame muestra información sobre los ejemplos.

  • Visite el sitio web Visual Studio 2008 Samples. Están disponibles las versiones de ejemplos más recientes.

  • Busque los ejemplos en el equipo en el que está instalado Visual Studio. De manera predeterminada, los ejemplos y el archivo Léame se instalan en unidad:\Archivos de programa\Microsoft Visual Studio 9.0\Samples\lcid. Para las versiones Express de Visual Studio, todos los ejemplos están en línea.

Para obtener más información, vea Localizar archivos de ejemplo.

.

Nota de seguridad:

En este ejemplo de código se ilustra un concepto y únicamente se muestra el código correspondiente a dicho concepto. Es posible que no cumpla los requisitos de seguridad de un entorno concreto y, por tanto, no debería utilizarse tal y como se muestra. Se recomienda agregar código de seguridad y de control de errores para que los proyectos sean más seguros y sólidos. Microsoft proporciona este ejemplo "tal cual" sin ninguna garantía.

Para ejecutar este ejemplo

1. Abra y genere el proyecto del visualizador de consultas.

2. Copie la DLL generada en la compilación del directorio bin de su proyecto al directorio Visualizers, que se encuentra de forma predeterminada en C:\Users\nombreDeUsuario\Documentos\Visual Studio 2008\Visualizers. Puede que tenga que crear el directorio Visualizers. En Windows XP y versiones anteriores, utilice el directorio Mis documentos en lugar de Documentos. Si tiene permisos, también puede copiar el archivo en el directorio siguiente:...\Archivos de programa\Microsoft Visual Studio 9.0\Common7\Packages\Debugger\Visualizers.

3. Si es necesario, salga de Visual Studio y reinicie el equipo para asegurarse de que se reconoce el visualizador.

4. Pruebe el visualizador en un proyecto de ejemplo existente, como SampleQueries, o cree una nueva aplicación de consola en la que probar el visualizador. Para crear una nueva aplicación, siga estos pasos:

   1. Cree una aplicación de consola predeterminada.

   2. Utilice Diseñador relacional de objetos para crear una asociación con la base de datos Northwind que se encuentra en el directorio de ejemplos.

   3. Abra el cuadro de diálogo Agregar nuevo elemento (Ctrl-Mayús-A) y haga clic en Clases de LINQ to SQL.

   4. Abra el Explorador de servidores presionando Ctrl + W, L.

   5. En el Explorador de servidores, haga clic en el botón Conectar con base de datos. Si es necesario, seleccione Archivo de base de datos de Microsoft SQL Server como Origen de datos. Busque la base de datos Northwind.mdb en el directorio Data que se incluye con los ejemplos.

   6. Arrastre la tabla Customers hasta la superficie del diseñador.

   7. Escriba una consulta simple, como la que se muestra aquí, y llámela:

      public void SimpleQuery()
      {
          DataClasses1DataContext db = new DataClasses1DataContext();
          var query = from c in db.Customers
                      select c;
          foreach (var item in query)
              Console.WriteLine(item.CompanyName);
      }
      

   8. Coloque un punto de interrupción en la línea foreach y ejecute la consulta hasta él.

   9. Desplace el puntero del mouse por encima de la consulta de nombre de variable y haga clic en el icono de lupa que aparece.

Demostraciones

El visualizador de consultas es una herramienta útil que se puede ejecutar en el depurador.

Nota:

Muchos de los ejemplos de LINQ requieren archivos XML o la versión de la base de datos de ejemplo Northwind ubicada en el ejemplo Data. Si instala el Ejemplo Data en la misma carpeta primaria que los otros ejemplos de LINQ, la ruta de acceso de los archivos XML y del archivo de base de datos se resolverá automáticamente. Muchos archivos de ejemplo también requieren el proyecto de Ejemplo Object Dumper.

Vea también

Otros recursos

Ejemplos de LINQ en C#

Introducción (LINQ to XML)