Instrucción Private
Se usa en el nivel de módulo para declarar variables privadas y asignar espacio de almacenamiento.
Sintaxis
Private [ WithEvents ] varname [ ( [ subíndices ] ) ] [ As [ New ] type ]
[ , [ WithEvents ] varname [ ( [ subíndices ] ) ] [ As [ New ] type ]] . . .
La sintaxis de la instrucción Private tiene estas partes:
| Parte | Descripción |
|---|---|
| WithEvents | Opcional. Keyword que especifica que varname es un objeto variable que se usa para responder a eventos activados por un objeto ActiveX. WithEvents solo es válido en módulos de clase. Puede declarar tantas variables individuales como desee mediante WithEvents, pero no puede crear matrices con WithEvents, ni puede usar New con WithEvents. |
| varname | Obligatorio. Nombre de la variable; sigue las convenciones de nomenclatura de variable estándar. |
| subscripts | Opcional. Dimensiones de una variable de matriz; se pueden declarar hasta 60 dimensiones distintas. El argumentosubíndices usa la sintaxis siguiente: [ lowerTo ] upper [ , [ lowerTo ] upper ] . . . Cuando no se encuentra de manera explícita en lower, el límite inferior de una matriz se controla mediante la instrucción Option Base. El límite inferior es cero si no existe una instrucción Option Base. |
| Nuevo | Opcional. Palabra clave que permite la creación implícita de un objeto. Si usa Nuevo al declarar la variable de objeto, se crea una nueva instancia del objeto en la primera referencia, por lo que no tiene que usar la instrucción Set para asignar la referencia de objeto. La palabra clave New no se puede usar para declarar variables de ningún tipo de datos intrínseco. Tampoco se puede usar para declarar instancias de objetos dependientes y no se puede usar con WithEvents. |
| type | Opcional. Tipo de datos de la variable; puede ser Byte, Boolean, Integer, Long, Currency, Single, Double, Decimal (no compatible actualmente), Date, String (para cadenas de longitud variable), Longitud de cadena (para cadenas de longitud fija), Object, Variant, un tipo definido por el usuario o un tipo de objeto. Utilizar una cláusula Astype independiente para cada variable que se define. |
Comentarios
Las variables Private solo están disponibles para el módulo en que se hayan declarado.
Use la instrucción Private para declarar el tipo de datos de una variable. Por ejemplo, la siguiente instrucción declara una variable como Integer:
Private NumberOfEmployees As Integer
También puede usar una instrucción Private para declarar el tipo de objeto de una variable. La siguiente instrucción declara una variable para una nueva instancia de una hoja de cálculo:
Private X As New Worksheet
Si no se usa la palabra clave New al declarar una variable de objeto, a la variable que hace referencia al objeto se le debe asignar un objeto existente mediante la instrucción Set antes de que se pueda usar. Hasta que se le asigna un objeto, la variable de objeto declarada tiene el valor especial Nothing, que indica que no hace referencia a ninguna instancia determinada de un objeto.
Si no especifica un tipo de datos o un tipo de objeto y no hay ninguna instrucción Deftype en el módulo, la variable es Variant de forma predeterminada.
También puede usar la instrucción Private con paréntesis vacíos para declarar una matriz dinámica. Después de declarar una matriz dinámica, use la instrucción ReDim dentro de un procedimiento para definir el número de elementos y dimensiones de la matriz. Si intenta volver a declarar una dimensión para una variable de matriz cuyo tamaño se especificó explícitamente en una instrucción Private, Public o Dim , se produce un error.
Cuando las variables se inicializan, se inicializa una variable numérica en 0, una cadena de longitud variable se inicializa en una cadena de longitud cero ("") y una cadena de longitud fija se completa con ceros. Las variables Variant se inicializan enEmpty. Cada elemento de una variable de tipo definido por el usuario se inicializa como si fuese una variable independiente.
Nota:
La instrucción Private no se puede usar dentro de un procedimiento; use la instrucción Dim para declarar variables locales.
Ejemplo
En este ejemplo se muestra la instrucción Private que se usa en el nivel de módulo para declarar variables como privadas; es decir, solo están disponibles para el módulo en el que se declaran.
Private Number As Integer ' Private Integer variable.
Private NameArray(1 To 5) As String ' Private array variable.
' Multiple declarations, two Variants and one Integer, all Private.
Private MyVar, YourVar, ThisVar As Integer
Vea también
Soporte técnico y comentarios
¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.