Método DBEngine.CreateWorkspace (DAO)

Aplica-se ao: Access 2013, Office 2013

Cria um novo objeto Workspace.

Sintaxe

expressão . CreateWorkspace(Name, UserName, Password, UseType)

expressão Uma variável que representa um objeto DBEngine.

Parâmetros

Nome	Necessária/opcional	Tipo de dados	Descrição
Name	Obrigatório	String	Uma String que denomina exclusivamente o novo objeto Workspace. Consulte a propriedade Name para obter detalhes sobre nomes válidos do Workspace .
UserName	Obrigatório	String	Um String que identifica o proprietário do novo objeto Workspace. Consulte a propriedade UserName para obter mais informações.
Password	Obrigatório	String	Uma Cadeia de Caracteres que contém a senha do novo objeto Workspace . A senha pode ter até 20 caracteres e pode incluir todos os caracteres, exceto o caractere ASCII 0 (nulo). OBSERVAÇÃO: use senhas fortes que combinam letras, números e símbolos maiúsculas e minúsculas. As enhas fracas não combinam esses elementos. Senha forte: Y6dh!et5. Senha fraca: Casa27. Use uma senha fraca para que você possa lembrá-la sem precisar escrevê-la.
UseType	Opcional	Variant	Um dos valores WorkspaceTypeEnum . OBSERVAÇÃO: o Microsoft Access 2013 não oferece suporte para espaços de trabalho ODBCDirect. Use o ADO para acessar fontes de dados externas sem usar o mecanismo de banco de dados do Microsoft Access.

Valor de retorno

Espaço de trabalho

Comentários

Após usar o método CreateWorkspace para criar um novo objeto Workspace, uma sessão do Workspace será iniciada e você poderá fazer referência ao objeto Workspace em seu aplicativo.

Objetos Workspace não são permanentes e não podem ser salvos em disco. Após criar um objeto Workspace, você não poderá alterar suas configurações de propriedade, com exceção da propriedade Name, que você pode modificar antes de acrescentar o objeto Workspace à coleção Workspaces.

Não é necessário acrescentar o novo objeto Workspace à coleção antes de usá-la. Acrescenta-se um objeto Workspace recém-criado apenas se for preciso fazer referência a ele por meio da coleção Workspaces.

Para remover um objeto Workspace da coleção Workspaces, feche todos os bancos de dados e conexões abertos e use o método Close no objeto Workspace.

Exemplo

Este exemplo usa o método CreateWorkspace para criar o workspace DoMicrosoft Access. Em seguida, ele lista as propriedades do workspace.

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