Private (Instrucción)

       

Se usa en el nivel de módulo para declarar variables privadas y para asignar espacio de almacenamiento.

Sintaxis

Private [WithEvents] nombre_variable[([subíndices])] [As [New] tipo] [,[WithEvents] nombre_variable[([subíndices])] [As [New] tipo]] . . .

La sintaxis de la instrucción Private consta de las siguientes partes:

Parte	Descripción
WithEvents	Opcional. Palabra clave que especifica que nombre_variable es una variable de objeto utilizada para responder a eventos desencadenados por un objeto ActiveX. WithEvents solamente es válido en módulos de clase. Puede declarar tantas variables individuales como desee mediante WithEvents, pero no puede crear matrices con WithEvents. No puede utilizar New con WithEvents.
nombre_ variable	Requerido. Nombre de la variable; sigue las convenciones estándar de nombres de variable.
subíndices	Opcional. Dimensiones de una variable de matriz; se pueden declarar hasta 60 dimensiones múltiples. El argumento subíndices utiliza la siguiente sintaxis:
	[inferior To] superior [,[inferior To] superior] . . .
	Cuando no se declara explícitamente en inferior, el límite inferior de una matriz se controla mediante la instrucción Option Base. El límite inferior es cero si no hay ninguna instrucción Option Base.
New	Opcional. Palabra clave que permite la creación implícita de un objeto. Si utiliza New cuando declara la variable de objeto, se crea una nueva instancia del objeto como primera referencia, de forma que no tiene que utilizar la instrucción Set para asignar la referencia del objeto. La palabra clave New no se puede utilizar para declarar variables de cualquier tipo de datos intrínseco, no se puede utilizar para declarar instancias de objetos dependientes y no se puede utilizar con WithEvents.
tipo	Opcional. Tipo de datos de la variable; puede ser Byte, Boolean, Integer, Long, Currency, Single, Double, Decimal (no admitida actualmente), Date, String (para cadenas de longitud variable), String * length (para cadenas de longitud fija), Object, Variant, un tipo definido por el usuario, o un tipo de objeto. Utilice una cláusula As tipo distinta para cada variable que defina.

Comentarios

Las variables Private sólo están disponibles para el módulo en el que se declaran.

Use la instrucción Private para declarar el tipo de datos de una variable. Por ejemplo, la instrucción siguiente declara una variable como un tipo Integer:

Private NúmeroDeEmpleados As Integer

Utilice también una instrucción Private para declarar el tipo de objeto de una variable. La siguiente línea declara una variable para una nueva instancia de una hoja de cálculo.

Private X As New Worksheet

Si no utiliza la palabra clave New al declarar una variable de objeto, la variable que se refiere al objeto debe asignarse a un objeto existente mediante la instrucción Set antes de que pueda utilizarse. Hasta que se le asigne un objeto, la variable de objeto declarada tiene el valor especial Nothing, el cual indica que no se refiere a ninguna instancia en particular de un objeto.

Si no se especifica un tipo de datos o un tipo de objeto y no existe una instrucción Deftipo en el módulo, la variable predeterminada es Variant.

También puede usar la instrucción Private con paréntesis vacíos para declarar matrices dinámicas. Después de declarar un matriz dinámica, use la instrucción ReDim dentro de un procedimiento para definir el número de dimensiones y elementos de una matriz. Si intenta volver a declarar una dimensión para una variable de matriz cuyo tamaño se ha especificado explícitamente en una instrucción Private, Public o Dim, ocurrirá un error.

Cuando se inicializan las variables, una variable numérica se inicializa a 0, una cadena de longitud variable se inicializa a una cadena de longitud cero ("") y una cadena de longitud fija se rellena con ceros. Las variables Variant se inicializan a Empty. Cada elemento de una variable de un tipo definido por el usuario se inicializa como si fuera una variable distinta.

Nota   Cuando utilice la instrucción Private en un procedimiento, generalmente incluirá dicha instrucción Private al principio del procedimiento.