Share via

Dividir una clase en clases parciales en el Diseñador de clases

  • Artículo

Puede usar la palabra clave partial (Partial en Visual Basic) para dividir la declaración de una clase o estructura entre varias declaraciones. Puede usar tantas declaraciones parciales como quiera.

Las declaraciones pueden estar en uno o en varios archivos de origen. Todas las declaraciones deben estar en el mismo ensamblado y en el mismo espacio de nombres.

Las clases parciales son útiles en varias situaciones. En un proyecto grande, por ejemplo, la separación de una clase en varios archivos permite que más de un programador trabaje en el proyecto al mismo tiempo. Cuando trabaja con código generado por Visual Studio, puede cambiar la clase sin tener que volver a crear el archivo de origen. (Los ejemplos de código generados por Visual Studio incluyen código de contenedor de Windows Forms y servicio web). Así, puede crear código que use clases generadas automáticamente sin necesidad de modificar el archivo creado por Visual Studio.

Hay dos tipos de métodos parciales. En C#, se denominan declarativo y de implementación. En Visual Basic, se denominan de declaración e implementación.

El Diseñador de clases admite clases y métodos parciales. La forma de tipo en el diagrama de clases hace referencia a una ubicación de declaración única para la clase parcial. Si se define la clase parcial en varios archivos, puede especificar la ubicación de la declaración que va a usar el Diseñador de clases al establecer la propiedad Ubicación de nuevos miembros en la ventana Propiedades. Es decir, al hacer doble clic en una forma de clase, el Diseñador de clases va al archivo de origen que contiene la declaración de clase identificada por la propiedad Ubicación de nuevos miembros. Cuando hace doble clic en un método parcial de una forma de clase, el Diseñador de clases va a la declaración de método parcial. Asimismo, en la ventana Propiedades, la propiedad Nombre de archivo hace referencia a la ubicación de la declaración. Para las clases parciales, Nombre de archivo enumera todos los archivos que contienen código de declaración e implementación de esa clase. Sin embargo, para los métodos parciales, Nombre de archivo muestra solo el archivo que contiene la declaración de método parcial.

Los siguientes ejemplos dividen la definición de la clase Employee en dos declaraciones, cada una de las cuales define otro procedimiento. Las dos definiciones parciales de los ejemplos podrían estar en un archivo de origen o en dos archivos distintos.

Nota

Visual Basic usa definiciones de clase parcial para separar el código generado por Visual Studio del código creado por el usuario. El código se divide en archivos de código fuente distintos. Por ejemplo, el Diseñador de Windows FormsForm define clases parciales para controles como . No debe modificar el código generado en estos controles.

Para obtener más información sobre los tipos parciales en Visual Basic, vea Partial.

Ejemplo

Para dividir una definición de clase, use la palabra clave partial (Partial en Visual Basic), como se muestra en el ejemplo siguiente:

// First part of class definition.
public partial class Employee
{
    public void CalculateWorkHours()
    {
    }
}

// Second part of class definition.
public partial class Employee
{
    public void CalculateTaxes()
    {
    }
}

Contenido relacionado