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:

  • Folhas de cálculo do Excel
  • Bancos de dados do Access
  • bases de dados SQL Server
  • Listas do SharePoint
  • Outras fontes de dados OLEDB/ODBC, por exemplo, bancos de dados Oracle
  • Ficheiros XML que cumprem o esquema XML clássico do ADO

Cada objeto de Documento do Visio tem uma coleção DataRecordsets , que está vazia até que seja estabelecida uma ligação a uma origem 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, pode utilizar um dos três métodos seguintes, consoante o tipo de origem de dados ao qual pretende ligar (OLEDB/ODBC ou XML) e como pretende transmitir cadeia de conexão e consultar cadeias de comandos ao Visio. Ao utilizar:

  • Método DataRecordsets.Add , pode ligar a uma origem de dados OLEDB ou ODBC e transmitir informações da cadeia de comandos de ligação e consulta ao Visio diretamente como parâmetros do método.

  • O método DataRecordsets.AddFromConnectionFile permite-lhe ligar-se a uma origem de dados OLEBD ou ODBC ao transmitir ao método um ficheiro ODC (Ligação de Dados do Office) que contém as informações da cadeia de comandos de ligação e consulta que pretende fornecer ao Visio.

  • Método DataRecordsets.AddFromXML , transmite ao método uma cadeia XML clássica do ADO que contém todos os dados que pretende incluir no conjunto de registos de dados.

Depois de criar um conjunto de registos de dados, a cadeia de comandos cadeia de conexão e consulta associada ao conjunto de registos de dados é representada pelas propriedades DataConnection.ConnectionString e CommandString, respetivamente.

Se o conjunto de registos de dados estiver associado a um objeto DataConnection , ou seja, se o tiver adicionado à coleção DataRecordsets com o método Add ou AddFromConnectionFile , pode utilizar a propriedade DataConnection para obter o objeto DataConnection associado.

A propriedade predefinida 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.

Utilize a propriedade Nome para associar um nome a apresentar ao conjunto de registos de dados.

Utilize o método GetDataRowIDs para obter uma matriz dos IDs de todas as linhas num conjunto de registos de dados, em que cada linha representa um único registo de dados. Depois de obter os IDs da linha de dados desta forma, pode utilizar o método GetRowData para obter todos os dados armazenados em cada coluna na linha de dados.

Utilize a propriedade DataColumns para obter o objeto DataColumn associado ao conjunto de registos 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á ligada a mais do que uma linha na mesma origem de dados ou quando uma forma está ligada a uma linha na origem de dados que foi eliminada. 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.

  • Last updated on