propriedade DataRecordset.Name (Visio)

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

Observação

This Visio object or member is available only to licensed users of Visio Professional 2013.

Sintaxe

expressão. 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 atribui um nome padrão, como Sheet1 , 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 com o valor da propriedade DataRecordset.ID . Uma ID específica é exclusiva para a vida útil do documento e você não pode reutilizá-lo, mesmo se você excluir o conjunto de registros de dados ao qual ele foi atribuído.

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.