Método DBEngine.CreateWorkspace (DAO)

Se aplica a: Access 2013, Office 2013

Crea un nuevo objeto Workspace.

Sintaxis

expresión . CreateWorkspace(Name, UserName, Password, UseType)

expression Variable que representa un objeto DBEngine.

Parameters

Nombre	Obligatorio/opcional	Tipo de datos	Descripción
Name	Obligatorio	String	String que identifica inequívocamente el nuevo objeto Workspace. Consulte la propiedad Name para obtener más información sobre los nombres de área de trabajo válidos.
UserName	Obligatorio	String	String que identifica el propietario del nuevo objeto Workspace. Vea el tema relativo a la propiedad UserName para obtener más información.
Password	Obligatorio	String	Cadena que contiene la contraseña del nuevo objeto Workspace. La contraseña puede tener hasta 20 caracteres y puede incluir cualquier carácter excepto el carácter ASCII 0 (null). NOTA: Use contraseñas seguras que combinen letras mayúsculas y minúsculas, números y símbolos. En las contraseñas no seguras estos elementos no se combinan. Contraseña segura: Y6dh!et5. Contraseña no segura: Casa27. Use una contraseña segura que pueda recordar para no tener que anotarla.
UseType	Opcional	Variant	Uno de los valores WorkspaceTypeEnum . NOTA: las áreas de trabajo de ODBCDirect no se admiten en Microsoft Access 2013. Use ADO si desea obtener acceso a orígenes de datos externos sin usar el motor de base de datos de Microsoft Access.

Valor devuelto

Área de trabajo

Comentarios

Una vez utilizado el método CreateWorkspace para crear un nuevo objeto Workspace, se inicia una sesión Workspace y puede hacer referencia al objeto Workspace en la aplicación.

Los objetos Workspace no son permanentes y no se pueden guardar en disco. Una vez creado un objeto Workspace, no puede modificar ninguno de los valores de sus propiedades, excepto en el caso de la propiedad Name, que puede modificar antes de agregar el objeto Workspace a la colección Workspaces.

No tiene que agregar el nuevo objeto Workspace a una colección para poder utilizarlo. Sólo debe agregar un objeto Workspace recién creado si necesita hacer referencia a él a través de la colección Workspaces.

Para quitar un objeto Workspace de la colección Workspaces, cierre todas las bases de datos y conexiones abiertas y, a continuación, utilice el método Close en el objeto Workspace.

Ejemplo

En este ejemplo se utiliza el método CreateWorkspace para crear un área de trabajo de Microsoft Access. A continuación, se muestran las propiedades del área de trabajo.

Sub CreateWorkspaceX() 
 
   Dim wrkAcc As Workspace 
   Dim wrkLoop As Workspace 
   Dim prpLoop As Property 
 
   DefaultType = dbUseJet 
   ' Create an unnamed Workspace object of the type  
   ' specified by the DefaultType property of DBEngine  
   ' (dbUseJet). 
   Set wrkAcc = CreateWorkspace("", "admin", "") 
 
   ' Enumerate Workspaces collection. 
   Debug.Print "Workspace objects in Workspaces collection:" 
   For Each wrkLoop In Workspaces 
      Debug.Print "  " & wrkLoop.Name 
   Next wrkLoop 
 
   With wrkAcc 
      ' Enumerate Properties collection of Microsoft Access  
      ' workspace. 
      Debug.Print _ 
         "Properties of unnamed Microsoft Access workspace" 
      On Error Resume Next 
      For Each prpLoop In .Properties 
         Debug.Print "  " & prpLoop.Name & " = " & prpLoop 
      Next prpLoop 
      On Error GoTo 0 
   End With 
 
   wrkAcc.Close 
 
End Sub