Compartilhar via


Objeto DataRecordset (Visio)

Armazena, formata, atualiza e expõe dados consultados de um banco de dados no Microsoft Visio.

Observação

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

Comentários

O Microsoft Visio pode se conectar aos dados de várias fontes, incluindo as seguintes:

  • Planilhas do Excel
  • Bancos de dados do Access
  • bancos de dados SQL Server
  • Listas do SharePoint
  • Outras fontes de dados OLEDB/ODBC, por exemplo, bancos de dados Oracle
  • Arquivos XML que aderem ao esquema XML clássico do ADO

Cada objeto Do Visio Document tem uma coleção DataRecordsets , que fica vazia até que uma conexão seja feita com uma fonte de dados. Para conectar um documento Visio a uma fonte de dados, é preciso adicionar um objeto DataRecordset à coleção DataRecordsets do documento.

Para adicionar um objeto DataRecordset à coleção DataRecordsets , você pode usar um dos três métodos a seguir, dependendo do tipo de fonte de dados ao qual você deseja se conectar (OLEDB/ODBC ou XML) e como deseja passar cadeias de conexão e consultar cadeias de caracteres de comando para o Visio. Usando o:

  • Método DataRecordsets.Add, você pode se conectar a uma fonte de dados OLEDB ou ODBC e passar informações de cadeia de caracteres de comando de conexão e consulta para o Visio diretamente como parâmetros de método.

  • Método DataRecordsets.AddFromConnectionFile, você pode se conectar a uma fonte de dados OLEBD ou ODBC passando o método um arquivo ODC (Conexão de Dados do Office) que contém as informações de cadeia de caracteres de comando de conexão e consulta que você deseja fornecer ao Visio.

  • Método DataRecordsets.AddFromXML, você passa pelo método uma cadeia de caracteres XML clássica do ADO que contém todos os dados que você deseja incluir no conjunto de registros de dados.

Depois de criar um conjunto de registros de dados, a cadeia de caracteres de conexão e a cadeia de comandos de consulta associadas ao conjunto de registros de dados são representadas pelas propriedades DataConnection.ConnectionString e CommandString , respectivamente.

Se o conjunto de registros de dados estiver associado a um objeto DataConnection , ou seja, se você o adicionou à coleção DataRecordsets usando o método Add ou AddFromConnectionFile , você poderá usar a propriedade DataConnection para obter o objeto DataConnection associado.

A propriedade padrão de um objeto DataRecordset é ID. O valor da propriedade ID identifica o DataRecordset na coleção DataRecordsets e é exclusivo na coleção para qualquer documento específico.

Use a propriedade Name para associar um nome de exibição ao conjunto de registros de dados.

Use o método GetDataRowIDs para obter uma matriz de IDs de todas as linhas em um conjunto de registros de dados, em que cada linha representa um único registro de dados. Depois de recuperar as IDs da linha de dados dessa maneira, você pode usar o método GetRowData para obter todos os dados armazenados em cada coluna na linha de dados.

Use a propriedade DataColumns para obter o objeto DataColumn associado ao conjunto de registros de dados. O objeto DataColumn expõe os métodos e as propriedades que você pode usar para personalizar o mapeamento das colunas de dados para as células na seção Shape Data da planilha ShapeSheet do Visio para as formas vinculadas a dados.

A definição de uma coluna de chaves primárias para um conjunto de registros de dados pode ajudar a evitar vínculos desfeitos entre formas e dados quando os dados forem atualizados. Para obter e definir a coluna de chaves primárias, use os métodos GetPrimaryKey e SetPrimaryKey, respectivamente.

Quando os dados forem alterados na fonte de dados, você poderá atualizar os dados de um conjunto de registros de dados conectado (não-XML) para refletir essas alterações. Você pode especificar que o Visio atualize os dados automaticamente em um intervalo especificado, definindo a propriedade RefreshInterval, ou pode atualizar os dados programaticamente chamando o método Refresh.

Quando você atualiza dados de uma fonte de dados alterada após a última atualização de dados, podem ocorrer conflitos. Os conflitos podem resultar quando uma única forma está vinculada a mais de uma linha na mesma fonte de dados ou quando uma forma está vinculada a uma linha na fonte de dados que foi excluída. Para detectar e resolver os conflitos resultantes da atualização de dados, use os métodos GetAllRefreshConflicts, GetMatchingRowsForRefreshConflict e RemoveRefreshConflict.

Observação

Quando você salva um documento do Visio contendo um ou mais conjuntos de registros de dados, todos os dados do conjunto de registros são salvos no arquivo do Visio. No caso de conjuntos de registros com grande volume de dados, isso poderá criar grandes arquivos do Visio e afetar o desempenho. Consequentemente, considere a filtragem de grandes fontes de dados antes de importá-las para o Visio.

Eventos

Métodos

Propriedades

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.