Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés

Creating and Configuring Type Members (Class Designer)

 

Puede agregar estos miembros a los tipos en un diagrama de clase y configurarlos en la ventana Detalles de clase:

Tipo

Miembros que puede contener

Clase

método, propiedad (para C# y Visual Basic), campo, evento (para C# y Visual Basic), constructor (método), destructor (método), constante

Enum

miembro

Interface

método, propiedad, evento (para C# y Visual Basic)

Clase abstracta

método, propiedad (para C# y Visual Basic), campo, evento (para C# y Visual Basic), constructor (método), destructor (método), constante

Estructura (struct en C#)

método, propiedad (para C# y Visual Basic), campo, evento (para C# y Visual Basic), constructor (método), constante

delegate

Parámetro

Módulo (solo en VB)

método, propiedad, campo, evento, constructor, constante

System_CAPS_noteNota

Haga que la declaración de la propiedad sea más concisa cuando no se requiere ninguna lógica adicional en los descriptores de acceso get y set de una propiedad usando las propiedades implementadas automáticamente (solo C#).Para mostrar la firma completa, en el menú Diagrama de clase, elija Cambiar formato de los miembros y, a continuación, haga clic en Mostrar signatura completa.Para obtener más información sobre las propiedades autoimplementadas, vea Propiedades autoimplementadas (Guía de programación de C#).

Tarea

Contenido adicional

Introducción: antes de crear y configurar los miembros de tipo, debe abrir la ventana Detalles de clase.

Crear y modificar miembros de tipo: puede crear nuevos miembros, modificar miembros y agregar parámetros a un método utilizando la ventana Detalles de clase.

De manera predeterminada, la ventana Detalles de clase aparece automáticamente cuando se abre un nuevo diagrama de clases (vea How to: Add Class Diagrams to Projects (Class Designer)).También puede abrir la ventana Detalles de clase de forma explícita de las maneras siguientes.

Para abrir la ventana Detalles de clase

  1. Haga clic con el botón derecho en cualquier clase del diagrama para que aparezca un menú contextual.

  2. En el menú contextual, haga clic en Ventana Detalles de clase.

O bien

  • Señale a Otras ventanas en el menú Ver y, a continuación, haga clic en Detalles de clase.

Puede crear un miembro con cualquiera de las herramientas siguientes:

  • Diseñador de clases

  • Barra de herramientas de la ventana Detalles de clase

  • Ventana Detalles de clase

System_CAPS_noteNota

Los procedimientos de esta sección también permiten crear constructores y destructores.Tenga presente que los constructores y destructores son tipos especiales de métodos y, como tales, aparecen en el compartimiento Métodos de las formas del diagrama de clases y en la sección Métodos de la cuadrícula de la ventana Detalles de clase.

System_CAPS_noteNota

La única entidad que puede agregar a un delegado es un parámetro.Tenga en cuenta que el procedimiento titulado 'Para crear un miembro con la barra de herramientas de la ventana Detalles de clase' no es válido para esta operación.

Para crear un miembro con el Diseñador de clases

  1. Haga clic con el botón derecho en el tipo al que desee agregar un miembro, elija Agregar y, a continuación, elija el tipo de miembro que desee agregar.

    Se crea una nueva firma de miembro y se agrega al tipo.Se le asigna un nombre predeterminado que puede cambiar en el Diseñador de clases, la ventana Detalles de clase o la ventana Propiedades.

  2. Si lo desea, puede especificar de forma opcional otros detalles sobre el miembro, como su tipo.

Para crear un miembro con la barra de herramientas de la ventana Detalles de clase

  1. En la superficie de diagrama, seleccione el tipo al que desee agregar un miembro.

    El tipo obtiene el foco y su contenido se muestra en la ventana Detalles de clase.

  2. En la barra de herramientas de la ventana Detalles de clase, haga clic en el icono superior y seleccione Nuevo <miembro> en la lista desplegable.

    El cursor se moverá al campo Nombre de una fila del tipo de miembro que desee agregar.Por ejemplo, si ha hecho clic en Nueva propiedad, el cursor se moverá a una nueva fila en la sección Propiedades de la ventana Detalles de clase.

  3. Escriba el nombre del miembro que desee crear y presione ENTRAR (o mueva el foco de otra forma, por ejemplo, presionando Tabulador).

    Se crea una nueva firma de miembro y se agrega al tipo.El miembro existe ahora en el código y aparece en el Diseñador de clases, la ventana Detalles de clase y la ventana Propiedades.

  4. Si lo desea, puede especificar de forma opcional otros detalles sobre el miembro, como su tipo.

Para crear un miembro con la ventana Detalles de clase

  1. En la superficie de diagrama, seleccione el tipo al que desee agregar un miembro.

    El tipo obtiene el foco y su contenido se muestra en la ventana Detalles de clase.

  2. En la ventana Detalles de clase, en la sección que contiene el tipo de miembro que desea agregar, haga clic en <agregar miembro>.Por ejemplo, si desea agregar un campo, haga clic en <agregar campo>.

  3. Escriba el nombre del miembro que desee crear y presione ENTRAR.

    Se crea una nueva firma de miembro y se agrega al tipo.El miembro existe ahora en el código y aparece en el Diseñador de clases, la ventana Detalles de clase y la ventana Propiedades.

  4. Si lo desea, puede especificar de forma opcional otros detalles sobre el miembro, como su tipo.

    Nota: También puede utilizar métodos abreviados de teclado para crear miembros.Para obtener más información, consulte Keyboard and Mouse Shortcuts in the Class Diagram and Class Details Window (Class Designer).

El Diseñador de clases permite modificar los miembros de los tipos que aparecen en el diagrama.Puede modificar los miembros de cualquier tipo que aparezca en un diagrama de clases que no sean de solo lectura.(Consulte Display of Read-Only Information (Class Designer)). Para modificar los miembros de tipo, se usa la edición en contexto en la superficie de diseño, la ventana Propiedades y la ventana Detalles de clase.

Todos los miembros mostrados en la ventana Detalles de clase representan los miembros de los tipos del diagrama de clases.Hay cuatro tipos de miembros: métodos, propiedades, campos y eventos.

Todas las filas de miembro aparecen bajo encabezados que agrupan los miembros por tipo.Por ejemplo, todas las propiedades aparecen bajo el encabezado Propiedades que, al igual que los nodos de la cuadrícula, se puede contraer o expandir.

Cada fila de miembro muestra los elementos siguientes:

  • Icono de miembro

    Cada tipo de miembro está representado por su propio icono.Señale con el mouse el icono del miembro para mostrar su firma.Haga clic en el icono del miembro o en el espacio en blanco situado a su izquierda para seleccionar la fila.

  • Member Name

    La columna Nombre de una fila muestra el nombre del miembro.Este nombre también se muestra en la propiedad Nombre de la ventana Propiedades.Use esta celda para cambiar el nombre de cualquier miembro que tenga permisos de lectura y escritura.

    Si la columna Nombre es demasiado estrecha como para mostrar el nombre completo, puede señalarlo con el mouse para que se muestre por completo.

  • Tipo de miembro

    La celda Tipo demiembro usa IntelliSense, lo que permite seleccionar un elemento en una lista con todos los tipos disponibles en el proyecto actual y en los proyectos a los que se hace referencia.

  • Modificador de miembro

    Cambie el modificador de visibilidad de un miembro a Public (public), Private (private), Friend (internal) Protected (protected), ProtectedFriend (protectedinternal) o Default.

  • <agregar miembro>

    La última fila de la ventana Detalles de clase contiene el texto <agregar miembro> en la celda Nombre.Puede crear un nuevo miembro haciendo clic en esta celda.Para obtener más información, vea Crear miembros.

  • Propiedades de miembro en la ventana Propiedades

    La ventana Detalles de clase muestra un subconjunto de las propiedades del miembro que se muestran en la ventana Propiedades.Al cambiar una propiedad en una ubicación, el valor de la propiedad se actualizará globalmente.Esta actualización incluye la presentación de su valor en la otra ubicación.

  • Resumen

    La celda Resumen muestra un resumen de la información sobre el miembro.Haga clic en los puntos suspensivos de la celda Resumen para ver o editar la información de Resumen, Tipo de valor devuelto y Comentarios del miembro.

  • Ocultar

    Cuando la casilla Ocultar está activada, el miembro no se muestra en el tipo.

Para modificar un miembro de tipo

  1. Con el Diseñador de clases, seleccione un tipo.

  2. Si no se muestra la ventana Detalles de clase, haga clic en el botón Ventana Detalles de clase en la barra de herramientas del Diseñador de clases.

  3. Edite los valores de los campos de la cuadrícula de la ventana Detalles de clase.Después de cada modificación, presione ENTRAR o aleje el foco del campo editado, presionando, por ejemplo, la tecla TAB.Los cambios se reflejan de inmediato en el código.

    System_CAPS_noteNota

    Si desea modificar únicamente el nombre de un miembro, puede hacerlo mediante la edición en contexto.

Agregue parámetros a los métodos mediante la ventana Detalles de clase.Los parámetros se pueden configurar como necesarios u opcionales.Al proporcionar un valor para la propiedad predeterminada opcional de un parámetro, se indica al diseñador que genere código como parámetro opcional.

Las filas de parámetros contienen los elementos siguientes:

  • Name

    La columna Nombre de una fila del parámetro muestra el nombre del parámetro.Este nombre también se muestra en la propiedad Nombre de la ventana Propiedades.Puede utilizar esta celda para cambiar el nombre de cualquier parámetro con permisos de lectura y escritura.

    Si la columna Nombre es demasiado estrecha para mostrar el nombre completo del parámetro, señale el nombre para que éste aparezca en la pantalla.

  • Tipo

    La celda Tipo de parámetro utiliza Intellisense, lo que permite elegir uno en una lista de todos los tipos disponibles en el proyecto actual y en los proyectos a los que se hace referencia.

  • Modificador

    La celda Modificador de una fila de parámetro acepta y muestra el nuevo modificador del parámetro.Para escribir un nuevo modificador de parámetro, use el cuadro de lista desplegable para seleccionar entre None, ref, out o params en C# y ByVal, ByRef o ParamArray en VB.

  • Resumen

    La celda Resumen de una fila de parámetro permite escribir comentarios de código que aparecen en IntelliSense al registrar el parámetro en el editor de código.

  • <agregar parámetro>

    La última fila de parámetros de un miembro contiene el texto <agregar parámetro> en la celda Nombre.Haga clic en esta celda para crear un nuevo parámetro.Para obtener más información, vea Para agregar un parámetro a un método.

Propiedades de parámetro en la ventana Propiedades

La ventana Propiedades muestra las mismas propiedades de parámetro que la ventana Detalles de clase: Nombre, Tipo, Modificador, Resumen, así como la propiedad predeterminada opcional.Al cambiar una propiedad en una ubicación, se actualiza globalmente el valor de la propiedad, incluida la presentación de su valor en la otra ubicación.

System_CAPS_noteNota

Para agregar un parámetro a un delegado, vea Crear miembros.

System_CAPS_noteNota

A pesar de ser un método, un destructor no puede tener parámetros.

  1. En la superficie de diagrama, haga clic en el tipo que contenga el método al que desee agregar un parámetro.

    El tipo obtiene el foco y su contenido se muestra en la ventana Detalles de clase.

  2. En la ventana Detalles de clase, expanda la fila del método al que desee agregar un parámetro.

    Aparece una fila de parámetro con sangría que solo contiene el siguiente texto entre paréntesis <agregar parámetro>.

  3. Haga clic en <agregar parámetro>, escriba el nombre del nuevo parámetro y presione Intro.

    El nuevo parámetro se agrega al método y al código de éste.Aparece en las ventanas Detalles de clase y Propiedades.

  4. De forma opcional, puede especificar otros detalles sobre el parámetro, como el tipo.

  1. En la superficie del diagrama, haga clic en el tipo que contenga el método al que desee agregar un parámetro opcional.

    El tipo obtiene el foco y su contenido se muestra en la ventana Detalles de clase.

  2. En la ventana Detalles de clase, expanda la fila del método al que desee agregar un parámetro opcional.

    Aparece una fila de parámetro con sangría que solo contiene el siguiente texto entre paréntesis <agregar parámetro>.

  3. Haga clic en <agregar parámetro>, escriba el nombre del nuevo parámetro y presione Intro.

    El nuevo parámetro se agrega al método y al código de éste.Aparece en las ventanas Detalles de clase y Propiedades.

  4. En la ventana Propiedades, escriba un valor para la propiedad predeterminada opcional.Al establecer la propiedad predeterminada opcional de un parámetro, ese parámetro pasa a ser opcional.

    System_CAPS_noteNota

    Los parámetros opcionales deben ser los últimos parámetros en la lista de parámetros.

Tenga en cuenta las siguientes sugerencias cuando utilice la ventana Detalles de clase.

Celdas modificables y no modificables

Todas las celdas de la ventana Detalles de clase son modificables, con unas pocas excepciones:

  • Todo el tipo es de solo lectura cuando, por ejemplo, reside en un ensamblado al que se hace referencia (vea Display of Read-Only Information (Class Designer)). Cuando se selecciona la forma en el Diseñador de clases, la ventana Detalles de clase muestra los detalles en estado de sólo lectura.

  • En el caso de los indizadores, el nombre es de sólo lectura y el resto de los datos (tipo, modificador, resumen) son modificables.

  • En la ventana Detalles de clase, los parámetros de todos los genéricos son de sólo lectura.Para cambiar un parámetro genérico, edite su código fuente.

  • El nombre del parámetro de tipo definido en un tipo genérico es de sólo lectura.

  • Cuando el código de un tipo está dañado (no es analizable), la ventana Detalles de clase muestra el contenido del tipo como de sólo lectura.

Ventana Detalles de clase y código fuente

  • Para ver el código fuente, puede hacer clic con el botón secundario del mouse en una forma de la ventana Detalles de clase (o del Diseñador de clases) y hacer clic en Ver código.El archivo de código fuente se abre y se desplaza hasta el elemento seleccionado.

  • Los cambios realizados en el código fuente se reflejan inmediatamente en la presentación de información de firma en el Diseñador de clases y en la ventana Detalles de clase.Si la ventana Detalles de clase está cerrada, la nueva información puede verse cuando se vuelve a abrir.

  • Cuando el código de un tipo está dañado (no es analizable), la ventana Detalles de clase muestra el contenido del tipo como de sólo lectura.

Funcionalidad del Portapapeles en la ventana Detalles de clase

Puede copiar o cortar campos o filas de la ventana Detalles de clase y pegarlos en otro tipo.Sólo puede cortar una fila si no es de sólo lectura.Cuando se pega la fila, la ventana Detalles de clase le asigna un nuevo nombre (derivado del nombre de la fila copiada) para evitar un conflicto.

El Diseñador de clases y la ventana Detalles de clase pueden mostrar los tipos (y los miembros de tipo) de:

  • un proyecto que contiene un diagrama de clases

  • un proyecto al que se hace referencia desde un proyecto que contiene un diagrama de clases

  • un ensamblado al que se hace referencia desde un proyecto que contiene un diagrama de clases

En los dos últimos casos, la entidad a la que se hace referencia (un tipo o miembro) es de solo lectura en el diagrama de clases que la representa.

Un proyecto completo o determinadas partes de él, como archivos individuales, pueden ser de sólo lectura.Los casos más comunes en los que un proyecto o uno de sus archivos es de sólo lectura se dan cuando está bajo control de código fuente (y no desprotegido), cuando existe en un ensamblado externo o cuando el sistema operativo considera que los archivos son de sólo lectura.

Control de código fuente

Dado que un diagrama de clases se guarda como un archivo en un proyecto, es necesario desproteger el proyecto para guardar cualquier cambio realizado en el Diseñador de clases o en la ventana Detalles de clase.

Proyectos de sólo lectura

El proyecto puede ser de sólo lectura por razones distintas del control de código fuente.Cuando se cierra el proyecto, aparece un cuadro de diálogo que pregunta si se desea sobrescribir el archivo de proyecto, descartar los cambios (no guardar) o cancelar la operación de cierre.Si elige sobrescribir, los archivos de proyecto se sobrescriben y pasan a ser de lectura y escritura.Se agrega el nuevo archivo de diagrama de clases.

Tipos de sólo lectura

Si intenta guardar un proyecto que contiene un tipo cuyo archivo de código fuente es de sólo lectura, aparece el cuadro de diálogo Guardar el archivo de sólo lectura, en él podrá elegir si desea guardar el archivo con otro nombre o en otra ubicación, o si desea sobrescribir el archivo de sólo lectura.Si sobrescribe el archivo, la nueva copia no será de sólo lectura.

Si un archivo de código contiene un error de sintaxis, las formas que muestran código de dicho archivo serán de sólo lectura hasta que se corrija el error de sintaxis.Mientras permanecen en este estado, las formas presentan el texto en color rojo, y aparece un icono rojo con la siguiente información sobre herramientas: "El archivo de código fuente contiene un error de análisis".

Los tipos a los que se hace referencia (como .NET Framework), que existen bajo el nodo de otro proyecto o bajo un nodo de ensamblado al que se hace referencia, aparecen indicados en la superficie de diseño del Diseñador de clases como de sólo lectura.Los tipos locales, que existen en el proyecto abierto, son de lectura y escritura, y así lo indica la forma correspondiente en la superficie de diseño del Diseñador de clases.

Los indizadores son de lectura y escritura en el código y en la ventana Detalles de clase, pero el nombre del indizador es de sólo lectura.

No puede modificar métodos parciales mediante el Diseñador de clases o la ventana Detalles de clase; debe utilizar el Editor de código para modificarlos.

No puede modificar el código C++ nativo mediante el Diseñador de clases o la ventana Detalles de clase; debe utilizar el Editor de código para modificar el código C++ nativo.

Título

Descripción

Viewing Types and Relationships (Class Designer)

Puede ver los tipos, los miembros y las relaciones existentes en un diagrama de clase.

Refactoring Classes and Types (Class Designer)

Mediante la refactorización, es sencillo cambiar el nombre del tipo y de los miembros de tipo.También puede mover los miembros entre las clases, dividir una clase en clases parciales e implementar interfaces.

Mostrar: