Examinador de objetos

El Examinador de objetos le permite seleccionar y examinar los símbolos que se pueden utilizar en proyectos. Puede abrir el Examinador de objetos desde el menú Ver o haciendo clic en el botón Examinador de objetos de la barra de herramientas principal.

Hay tres paneles: un panel Objetos a la izquierda, un panel Miembros en la parte superior derecha y un panel Descripción en la parte inferior derecha. Si cambia el tamaño del Examinador de objetos para que sólo tenga una columna, el panel Objetos se desplazará a la parte superior, el panel Miembros al medio y el panel Descripción a la parte inferior.

En el panel Objetos, los iconos identifican las estructuras jerárquicas como componentes .NET Framework y COM, espacios de nombres, bibliotecas de tipos, interfaces, enumeraciones y clases. Puede expandir estas estructuras para mostrar listas ordenadas de sus miembros. En el panel Miembros se muestran propiedades, métodos, eventos, variables, constantes y otros elementos contenidos. En el panel Descripción se muestran detalles sobre el elemento seleccionado en el panel Objetos o Miembros.

La lista desplegable Ámbito de exploración le permite especificar cualquier versión de .NET Framework instalada en su equipo. También se puede restringir a los proyectos que está desarrollando y a los componentes a los que hacen referencia, o bien, se puede ampliar para incluir todo .NET Framework, todos los componentes COM instalados en el equipo y todos los componentes externos a los que puede tener acceso. También puede especificar un conjunto personalizado de carpetas para examinar. Para obtener más información, vea Cómo: Modificar el ámbito de exploración en el Examinador de objetos.

Para obtener más información sobre el uso del Examinador de objetos, vea Examinar código y componentes. Para ver una guía de los iconos mostrados, vea Iconos de la Vista de clases y del Examinador de objetos.

Este tema se organiza en las secciones siguientes:

• Barra de herramientas Examinador de objetos

• Panel de objetos

• Panel de miembros

• Panel de descripción

• Ayuda para símbolos

Barra de herramientas Examinador de objetos

La barra de herramientas Examinador de objetos le permite definir el ámbito de exploración, buscar objetos, navegar dentro de los paneles Objetos y Miembros, agregar referencias a un proyecto, seleccionar una vista lógica o física, elegir los elementos que se van a mostrar y ordenar esos elementos de la manera deseada.

Menú Examinar

Especifica el ámbito de exploración para el panel Objetos. Puede restringir el ámbito a la solución actual o ampliarlo para incluir todos los componentes disponibles. Dentro de cualquier ámbito, puede utilizar Búsqueda para mostrar un subconjunto de los componentes disponibles. También puede seleccionar Editar conjunto de componentes personalizado para definir el ámbito de exploración Conjunto de componentes personalizados.

• Todos los componentes
  Muestra los objetos de todo .NET Framework, la solución en uso y los componentes a los que se hace referencia, así como cualquier otro componente que haya agregado seleccionando Editar conjunto de componentes personalizado.

• <Versiones de Framework>
  Puede elegir mostrar los objetos para una versión específica de .NET Framework y .NET Compact Framework. Por ejemplo, si tiene instalados .NET Framework 2.0 y .NET Framework 3.0 en su equipo, puede optar por mostrar únicamente .NET Framework 3.0. Es posible que esta lista también incluya marcos registrados de otros fabricantes.

• Mi solución
  Muestra los objetos de la solución actual y sus componentes a los que se hace referencia.

• Conjunto de componentes personalizados
  Muestra los objetos de cualquier componente que haya agregado seleccionando Editar conjunto de componentes personalizado.

• Editar conjunto de componentes personalizado
  Muestra el Editar conjunto de componentes personalizado (Cuadro de diálogo). También puede hacer clic en el botón Examinar (...) para mostrar este cuadro de diálogo. Le permite seleccionar las jerarquías de objetos de sus proyectos, de componentes a los que se hace referencia en sus proyectos y de componentes externos.

Menú Búsqueda

El menú Búsqueda le permite buscar objetos dentro del panel Objetos. Puede seleccionar una cadena de búsqueda anterior o escribir una nueva. Los resultados se muestran en el panel Objetos como una sublista filtrada de su contenido original. Para volver a mostrar el ámbito completo de Examinar, haga clic en Borrar búsqueda. Una búsqueda devuelve todos los nombres de símbolo del ámbito de exploración actual donde la cadena de búsqueda coincide con cualquier parte del nombre de símbolo. Por ejemplo, una búsqueda de la cadena "MyObject" devuelve los nombres "MyObject", "MyObjectTest" y "CMyObject". Las búsquedas distinguen mayúsculas de minúsculas.

• Cadena de búsqueda
  Le permite seleccionar una cadena en el menú desplegable o escribir una nueva cadena de búsqueda. Puede escribir el nombre completo de un símbolo o una subcadena que aparece en muchos símbolos.

• Buscar
  Haga clic en este botón para mostrar únicamente aquellos objetos dentro del ámbito Examinar y cuyos nombres incluyan la Cadena de búsqueda. La cadena está resaltada en cada nombre de símbolo donde se encuentre una coincidencia.

• Borrar búsqueda
  Haga clic en este botón para borrar el campo Cadena de búsqueda y mostrar todos los objetos disponibles en el ámbito Examinar.

Botones de barra de herramientas

Los botones de la barra de herramientas Examinador de objetos le permiten navegar dentro de los paneles Objetos y Miembros, así como agregar referencias a un proyecto.

• Atrás
  Navega al elemento seleccionado anteriormente. Siga haciendo clic en este botón para navegar por los elementos seleccionados previamente hasta que llegue al primer elemento examinado. Los botones Atrás y Adelante permiten navegar por un historial de elementos examinados previamente.

• Adelante
  Está disponible cuando hace clic en el botón Atrás. Navega al siguiente elemento seleccionado. Siga haciendo clic en este botón para volver al elemento seleccionado más recientemente. Los botones Atrás y Adelante permiten desplazarse por un historial de elementos examinados previamente.

• Agregar a las referencias del proyecto seleccionado
  Inserta una referencia al componente seleccionado en el proyecto seleccionado actualmente en el Explorador de soluciones. Para obtener más información, vea Cómo: Agregar o quitar referencias en Visual Studio.

Configuración del Examinador de objetos

El menú Configuración del Examinador de objetos en la barra de herramientas Examinador de objetos le permite elegir una vista determinada de los objetos dentro del ámbito Examinar actual y especificar cuáles de los objetos disponibles se mostrarán. Las opciones disponibles están en la lista siguiente. Algunos de estos comandos también están disponibles desde los menús contextuales de los paneles Objetos y Miembros.

• Ver espacio de nombres
  Cuando se selecciona, los elementos de nivel superior del panel Objetos son los espacios de nombres lógicos. Se combinan los espacios de nombres almacenados en varios contenedores físicos. Éstos se expanden para mostrar los tipos de clase que contienen.

• Ver contenedores
  Cuando se selecciona, los elementos de nivel superior del panel Objetos son los contenedores físicos; por ejemplo, componentes, ensamblados, archivos de explorador de código fuente (.bsc) y bibliotecas de tipos de resultados (.tlb). Éstos se expanden para mostrar los espacios de nombres que contienen.

• Mostrar tipos base
  Alterna la presentación de los tipos base en el panel Objetos.

• Mostrar tipos derivados
  Alterna la presentación de los tipos derivados en el panel Objetos. Disponible sólo para proyectos de Visual C++ y .NET Framework.

• Mostrar tipos y miembros ocultos
  Alterna la presentación de los tipos ocultos en el panel Objetos y de los miembros ocultos en el panel Miembros.

• Mostrar miembros públicos
  Se muestran los miembros públicos a los usuarios que están utilizando las clases.

• Mostrar miembros protegidos
  Se muestran los miembros públicos o protegidos a los usuarios que están ampliando las clases.

• Mostrar miembros privados
  Se muestran los miembros de todos los niveles de accesibilidad a los usuarios que están implementando y utilizando las clases.

• Mostrar otros miembros
  Se muestran los miembros que no entran dentro de la categoría de públicos, protegidos, privados o heredados. Ejemplos:

  En el siguiente código de Visual Basic, "Friend" está incluido en esta categoría:

  Friend Sub Test()
  End Sub
  

  En el siguiente código de Visual C#, "internal" está incluido en esta categoría:

  internal void InternalF() { }
  

• Mostrar miembros heredados
  Alterna la presentación de los miembros heredados en el panel Miembros.

• Muestra métodos de extensión
  Alterna la presentación de los métodos de extensión en el panel Miembros. Para obtener más información, vea Métodos de extensión (Guía de programación de C#) y Métodos de extensión (Visual Basic).

Panel de objetos

El panel Objetos muestra una lista de símbolos que se puede expandir cuyos nodos de nivel superior representan componentes o espacios de nombres disponibles dentro del ámbito de exploración actual. Estos nodos de nivel superior suelen contener símbolos que contienen otros símbolos. Para expandir un nodo seleccionado en la lista, haga clic en su signo más (+) correspondiente o presione la tecla más (+) del teclado numérico.

Cuando selecciona un elemento en el panel Objetos, sus miembros se muestran en el panel Miembros y los detalles sobre el elemento aparecen en el panel Descripción. Al expandir un nodo, se proporciona información adicional sobre un símbolo. Cuando expande un componente, se muestran sus espacios de nombres. Al expandir un espacio de nombres, se muestran las clases que están definidas en él. También se enumeran las clases base, las interfaces implementadas, los métodos de extensión y los reemplazos disponibles.

Los objetos anidados se simplifican y se muestran al mismo nivel. Por ejemplo, si la clase primaria CMyClass incluye una subclase CNestedClass, estas dos clases se muestran como relacionadas dentro de su espacio de nombres. Sus nodos Examinador de objetos se denominan CMyClass y CMyClass::CnestedClass en Visual C++ y CMyClass.CnestedClass en Visual C# y Visual Basic para indicar que la clase anterior contiene a la última.

Menú contextual del panel Objetos

Si hace clic con el botón secundario del mouse en un símbolo, aparece el menú contextual del panel Objetos. Además de los comandos de Configuración del Examinador de objetos enumerados anteriormente, en este menú pueden aparecer uno o varios de los comandos siguientes, dependiendo del símbolo seleccionado:

• Examinar definición
  Le lleva al nodo principal (normalmente, el nivel superior) del símbolo seleccionado en el Examinador de objetos.

• Buscar todas las referencias
  Realiza una búsqueda en el símbolo del objeto seleccionado actualmente utilizando las opciones especificadas en Buscar símbolo, Buscar y reemplazar (Ventana). Muestra los resultados en la ventana Resultados de la búsqueda de símbolos (Ventana).

• Filtro a tipo
  Muestra sólo el tipo seleccionado en el panel Objetos y los miembros de ese tipo en el panel Miembros.

• Copiar
  Copia una referencia de símbolos que puede pegarse en un diseñador; también copia en el Portapapeles la ruta de acceso completa y el nombre del elemento seleccionado.

• Remove
  Le permite quitar un componente externo del ámbito de exploración actual, utilizando el cuadro de diálogo Componentes seleccionados.

• Ver espacio de nombres
  Cuando se selecciona, los elementos de nivel superior del panel Objetos son los espacios de nombres lógicos. Se combinan los espacios de nombres almacenados en varios contenedores físicos. Éstos se expanden para mostrar los tipos de clase que contienen.

• Ver contenedores
  Cuando se selecciona, los elementos de nivel superior del panel Objetos son los contenedores físicos; por ejemplo, proyectos, componentes, ensamblados, archivos de explorador de código fuente (.bsc) y bibliotecas de tipos de resultados (.tlb). Éstos se pueden expandir para mostrar los espacios de nombres que contienen.

• Ordenar alfabéticamente
  Los objetos se muestran alfabéticamente por sus nombres en orden ascendente (de la A a la Z).

• Ordenar por tipo de objeto
  Los objetos se muestran según el orden de su tipo, como clases base, seguido de clases derivadas, interfaces, métodos, etc.

• Ordenar por acceso a objetos
  Los objetos se muestran por orden de su tipo de acceso, como público o privado.

• Agrupar por tipo de objeto
  Los objetos se ordenan agrupados por tipo, como clases, interfaces, propiedades, métodos, etc.

• Ir a declaración
  Proporciona la declaración del símbolo en el código, si está disponible. Sólo está disponible en proyectos de Visual C++.

• Ir a definición
  Le lleva a la definición del símbolo en el código, si está disponible.

• Ir a referencia
  Le lleva a una referencia al símbolo en el código, si está disponible.

Panel de miembros

Cada objeto puede contener miembros como propiedades, métodos, eventos, constantes, variables y valores de enumeración. Si selecciona un objeto en el panel Objetos, sus miembros aparecen en el panel Miembros. En el panel Descripción se muestran detalles sobre el elemento seleccionado en el panel Miembros.

Menú contextual del panel Miembros

Haga clic con el botón secundario del mouse en cualquier miembro del panel Miembros para mostrar el menú contextual. Este menú le permite buscar, ordenar y copiar miembros independientemente de sus objetos primarios. Este menú contextual también incluye comandos que le permiten especificar qué miembros se mostrarán, por ejemplo si se mostrarán o no los miembros ocultos o heredados.

• Buscar todas las referencias
  Realiza una búsqueda en el símbolo del miembro seleccionado actualmente utilizando las opciones especificadas en Buscar símbolo, Buscar y reemplazar (Ventana). Muestra los resultados en la ventana Resultados de la búsqueda de símbolos (Ventana).

• Copiar
  Copia una referencia de símbolos que puede pegarse en un diseñador; también copia en el Portapapeles la ruta de acceso completa y el nombre del elemento seleccionado.

• Agrupar por tipo de miembro
  Los miembros están organizados por tipo.

• Mostrar miembros públicos
  Se muestran los miembros públicos a los usuarios que están utilizando las clases.

• Mostrar miembros protegidos
  Se muestran los miembros públicos o protegidos a los usuarios que están ampliando las clases.

• Mostrar miembros privados
  Se muestran los miembros de todos los niveles de accesibilidad a los usuarios que están implementando y utilizando las clases.

• Mostrar otros miembros
  Se muestran los miembros que no entran dentro de la categoría de públicos, protegidos, privados o heredados. Ejemplos:

  En el siguiente código de Visual Basic, "Friend" está incluido en esta categoría:

  Friend Sub Procedure()
  End Sub
  

  En el siguiente código de Visual C#, "internal" está incluido en esta categoría:

  internal void InternalF() { }
  

• Mostrar miembros heredados
  Alterna la presentación de los miembros heredados en el panel Miembros.

• Ordenar alfabéticamente
  Los miembros se muestran alfabéticamente por sus nombres en orden ascendente (de la A a la Z).

• Ordenar por tipo de miembro
  Los miembros se enumeran por orden de tipo, como bases, seguidos de interfaces, métodos, etc.

• Ordenar por acceso a miembros
  Los miembros se muestran por orden de su tipo de acceso, como público o privado.

Panel de descripción

En el panel Descripción se muestra información detallada sobre el objeto o el miembro seleccionado actualmente. Puede copiar datos del panel Descripción al Portapapeles y, después, pegarlos en el Editor de código. La información que se presenta depende de la selección y puede incluir lo siguiente:

• El nombre y el objeto primario.

• Propiedades y atributos.

• Sintaxis en el lenguaje de programación del proyecto activo.

• Los vínculos con miembros y objetos relacionados.

• Descripciones, comentarios y texto de Ayuda.

• Versión de .NET Framework en la que el objeto o el miembro están incluidos.

El tipo de símbolo seleccionado determina qué información se muestra.

Examinar definición

El comando Examinar definición está disponible en el menú contextual del panel Descripción y, para los nodos profundamente anidados, en el Examinador de objetos. También está disponible en los menús contextuales del Editor de código, la Vista de clases y la ventana Resultados de la búsqueda de símbolos cuando hay un símbolo seleccionado.

Si el símbolo está definido en su código, el archivo de código fuente se abre en el Editor de código y se desplaza hasta la definición. Si el símbolo es una clase de .NET Framework o un componente COM, Ir a definición selecciona su nodo principal en el panel Objetos, muestra sus miembros en el panel Miembros y muestra detalles sobre el símbolo en el panel Descripción.

Ayuda para símbolos

Puede presionar F1 en cualquier símbolo para ver un tema de Ayuda sobre el mismo, si hay alguno disponible. Esto no sólo se aplica a .NET Framework y a los componentes COM, sino también a muchos componentes de terceros.

Vea también

Tareas

Cómo: Explorar en el Examinador de objetos

Cómo: Buscar objetos, definiciones y referencias (símbolos)

Referencia

Vista de clases

Ver clases y sus miembros