Método Index.CreateProperty (DAO)
Aplica-se ao: Access 2013, Office 2013
Cria um novo objeto Property definido pelo usuário (apenas espaços de trabalho do Microsoft Access).
Sintaxe
expressão . CreateProperty(Name, Type, Value, DDL)
Expressão Uma variável que representa um objeto Index .
Parâmetros
Nome |
Necessária/opcional |
Tipo de dados |
Descrição |
|---|---|---|---|
Name |
Opcional |
Variant |
Uma String que denomina exclusivamente o novo objeto Property. Consulte a propriedade Name para obter detalhes sobre nomes válidos de Property. |
Type |
Opcional |
Variant |
Uma constante que define o tipo de dados do novo objeto Property. Consulte a propriedade Type para obter tipos de dados válidos. |
Valor |
Opcional |
Variant |
Um Variant que contém o valor inicial da propriedade. Consulte a propriedade Value para obter detalhes. |
DDL |
Opcional |
Variant |
Um Variant (subtipo Boolean) que indica se Property é ou não um objeto DDL. O padrão é False. Se o DDL for True, os usuários não poderão alterar ou excluir esse objeto Property , a menos que tenham permissão dbSecWriteDef . |
Valor de retorno
Propriedade
Comentários
Você pode criar um objeto Property definido pelo usuário na coleção Properties de um objeto que é persistente.
Se você omitir uma ou mais das partes opcionais ao utilizar CreateProperty, poderá usar uma instruções de atribuição apropriada para definir ou redefinir a propriedade correspondente antes de acrescentar o novo objeto a uma coleção. Depois de acrescentar o objeto, você poderá alterar algumas, mas não todas, as configurações de propriedade. Consulte os tópicos de propriedade Name, Type e Value para obter mais detalhes.
Se o nome se referir a um objeto que já é um membro da coleção, ocorrerá um erro em tempo de execução ao usar o método Append .
Para remover um objeto Property definido pelo usuário da coleção, use o método Delete na coleção Properties. Não é possível excluir propriedades internas.
Observação
Se você omitir o argumento DDL, ele será padrão para False (não DDL). Como nenhuma propriedade DDL correspondente está exposta, você deve excluir e recriar um objeto Property que deseja alterar de DDL para não DDL.