DBEngine.CreateWorkspace, méthode (DAO)

Article
08/18/2023

S’applique à : Access 2013, Office 2013

Crée un nouvel objet Workspace.

Syntaxe

expression . CreateWorkspace(Name, UserName, Password, UseType)

expression Variable représentant un objet DBEngine.

Paramètres

Nom	Obligatoire/facultatif	Type de données	Description
Name	Obligatoire	String	Type String qui identifie par un nom unique le nouvel objet Workspace. Consultez la propriété Name pour plus d’informations sur les noms d’espace de travail valides.
UserName	Obligatoire	String	Type String qui identifie le propriétaire du nouvel objet Workspace. Pour plus d’informations, consultez la propriété UserName.
Password	Obligatoire	String	Chaîne contenant le mot de passe du nouvel objet Workspace. Le mot de passe peut contenir jusqu’à 20 caractères et peut inclure n’importe quel caractère, à l’exception du caractère ASCII 0 (null). REMARQUE : Utilisez des mots de passe forts qui combinent des lettres majuscules et minuscules, des chiffres et des symboles. Les mots de passe faibles ne regroupent pas ces éléments. Mot de passe fort : Y6dh!et5. Mot de passe faible : Maison27. Utilisez un mot de passe fort facile à mémoriser afin de ne pas avoir à le noter.
UseType	Facultatif	Variant	Une des valeurs WorkspaceTypeEnum . NOTE : Les espaces de travail ODBCDirect ne sont pas pris en charge dans Microsoft Access 2013. Utilisez ADO si vous voulez accéder aux sources de données externes sans avoir recours au moteur de base de données Microsoft Access.

Valeur renvoyée

Espace de travail

Remarques

Dès que vous utilisez la méthode CreateWorkspace pour créer un nouvel objet Workspace, une session Workspace est démarrée et vous pouvez référencer l'objet Workspace dans votre application.

Les objets Workspace ne sont pas permanents et vous ne pouvez pas les enregistrer sur disque. Dès que vous créez un objet Workspace, il est impossible de changer les paramètres de ses propriétés, à l'exception de la propriété Name, que vous pouvez modifier avant d'ajouter l'objet Workspace à la collection Workspaces.

Il n'est pas nécessaire d'ajouter le nouvel objet Workspace à une collection avant de pouvoir l'utiliser. Vous ajoutez un nouvel objet Workspace uniquement si vous devez y faire référence via la collection Workspaces.

Pour supprimer un objet Workspace de la collection Workspaces, fermez toutes les bases de données et connexions ouvertes puis appelez la méthode Close sur l'objet Workspace.

Exemple

Cet exemple montre comment utiliser la méthode CreateWorkspace pour créer un espace de travail Microsoft Access. Il donne ensuite la liste des propriétés de l'espace de travail.

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

Partager via