DataRecordset.Name propriedade (Visio)

Obtém ou define o nome para exibição do conjunto de registros de dados. Leitura/gravação.

Sintaxe

mais simples. Nome

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

Valor de retorno

Cadeia de caracteres

Comentários

O nome de exibição de um objeto DataRecordset é o nome que você passou como o parâmetro Name para o método DataRecordsets.Add, DataRecordsets.AddFromConnectionFile ou DataRecordsets.AddFromXML quando você criou o conjunto de registros de dados pela primeira vez; ou o nome que você atribuiu posteriormente definindo essa propriedade. Se você não atribuir um nome ao criar um conjunto de registros de dados, o Microsoft Visio atribuirá um nome padrão, como Planilha1 , que seria o nome atribuído se você importasse dados de uma pasta de trabalho do Microsoft Excel.

Se você especificar (no parâmetro AddOptions de um dos métodos Add) a exibição da janela Dados Externos na interface do usuário do Visio, o nome para exibição aparecerá na guia da janela Dados Externos que corresponde ao conjunto de registros de dados.

O valor de propriedade Name deve ser exclusivo em um documento específico — não é possível atribuir o mesmo nome para exibição a mais de um conjunto de registros de dados. Se você tentar atribuir o valor de propriedade Name de um conjunto de registros de dados existente a outro conjunto de registros de dados no mesmo documento, a atribuição falhará. Se você adicionar um novo conjunto de registros de dados a um documento usando o método Add e se passar para o método Add o nome de um conjunto de registros de dados existente como um nome para exibição, o Visio acrescentará um traço e um numeral (-1, por exemplo) ao nome para torná-lo exclusivo no contexto do documento.

Entretanto, se excluir um conjunto de registros de dados, você poderá reutilizar o nome para exibição do conjunto de registros de dados excluído para outro conjunto de registros de dados no mesmo documento. Isso contrasta com o caso do valor da propriedade DataRecordset.ID . Uma ID específica é exclusiva durante a vida útil do documento e você não pode reutilizá-la, mesmo se excluir o conjunto de registros de dados ao qual ela foi atribuída.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.