Método DataRecordsets.AddFromConnectionFile (Visio)

Adiciona um objeto DataRecordset à coleção DataRecordsets usando as informações de conexão e consulta contidas em um arquivo ODC (Conexão de Dados do Office) para se conectar e recuperar dados de uma fonte de dados OLEDB ou ODBC.

Observação

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

Sintaxe

expressão. AddFromConnectionFile (FileName, AddOptions, Name)

Expressão Uma expressão que retorna um objeto DataRecordsets .

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
FileName	Obrigatório	String	O nome do arquivo de conexão ODC a ser utilizado.
AddOptions	Obrigatório	Long	Opções que determinam as propriedades do conjunto de registro de dados a ser adicionado. Uma combinação de um ou mais valores enumerados de VisDataRecordsetAddOptions. Para obter mais informações, consulte Comentários.
Name	Opcional	String	Atribui ao objeto DataRecordset adicionado um nome para exibição.

Valor de retorno

DataRecordset

Comentários

Como parâmetro FileName, passa o nome e o caminho completo de um arquivo ODC que contém uma cadeia de caracteres de conexão que especifica como se conectar a uma fonte de dados OLEDB ou ODBC e uma cadeia de caracteres de consulta que especifica como extrair da fonte os dados desejados.

Ele usa HTML e XML para armazenar as informações de conexão e consulta. É possível exibir ou editar o conteúdo do arquivo em qualquer editor de texto. Os arquivos ODC possuem a extensão de nome de arquivo .odc. Use o Assistente de Conexão de Dados no Microsoft Access ou no Microsoft Excel para criar um arquivo ODC que se conectará e recuperará os dados desejados.

O parâmetro AddOptions pode ser uma combinação de um ou mais dos valores a seguir, contidos na enumeração VisDataRecordsetAddOptions, que é declarada na biblioteca de tipos do Visio. O padrão é zero (0), o que especifica que nenhuma das opções seja definida.

Constant	Valor	Descrição
visDataRecordsetNoExternalDataUI	1	Impede que os dados de um novo conjunto de registros de dados sejam exibidos na janela Dados Externos.
visDataRecordsetNoRefreshUI	2	Impede que o conjunto de registros de dados seja incluído na operação de atualização e exibido na caixa de diálogo Atualizar Dados.
visDataRecordsetNoAdvConfig	4	Impede que o conjunto de registros de dados seja exibido na caixa de diálogo Configurar Atualização.
visDataRecordsetDelayQuery	8	Adiciona um conjunto de registros de dados, mas não executa a consulta CommandString até a próxima vez em que se chame o método Refresh.
visDataRecordsetDontCopyLinks	16	Adiciona um conjunto de registros de dados, mas os links de dados de forma não são cortados ou copiados.

Depois de atribuir esses valores, você não pode alterá-los durante a existência do objeto DataRecordset.

O argumento Name é uma cadeia de caracteres opcional que permite atribuir ao conjunto de registros de dados um nome para exibição. Caso você especifique que a janela Dados Externos seja exibida na interface do usuário do Visio, o nome que você passar para esse argumento aparecerá na guia da janela Dados Externos correspondente ao conjunto de registros de dados adicionado.

Se o método AddFromConnectionFile for bem-sucedido, ele executará as seguintes ações:

• Cria um objeto DataRecordset e atribui a ele o nome especificado no parâmetro Name. Se você não especificar um nome, o Visio atribuirá o conjunto de registros de dados ao nome da tabela de banco de dados que é a fonte dos dados.

• Associa um objeto DataConnection novo ou existente ao objeto DataRecordset.

• Executa a cadeia de caracteres de consulta especificada na cadeia de caracteres de comando dentro do arquivo ODC e recupera os dados resultantes.

• Mapeia os tipos de dados das colunas da fonte de dados para os tipos de dados do Visio equivalentes, enquanto filtra o resultado para remover as colunas dados-fonte que não possam ser vinculadas a formas do Visio por não existir equivalência com um tipo de dado do Visio.

• Atribui uma identificação de linha a cada linha do conjunto de registros de dados. Para obter mais informações sobre IDs de linha, consulte o tópico de propriedade DataRecordset.GetDataRowIDs .

Observação

O método AddFromConnectionFile falha e retorna uma exceção caso encontre erros de conexão de rede, problemas de tempo limite de rede, ou erros de permissões de banco de dados.

Exemplo

A macro VBA (Microsoft Visual Basic for Applications) a seguir mostra como você pode usar o método AddFromConnectionString para conectar um desenho do Visio para se conectar aos dados na tabela Produtos do banco de dados Northwind fornecido com o Microsoft Access. Antes de executar esse código de exemplo, use o Assistente de Conexão de Dados para criar um arquivo ODC e substitua o valor da variável strFile pelo caminho completo para e o nome do arquivo ODC que você criou. Opcionalmente, forneça um valor diferente para a variável strName .

Public Sub AddFromConnectionFile_Example() 
 
    Dim strFile As String 
    Dim strName As String 
    Dim vsoDataRecordset As Visio.DataRecordset 
 
    strFile = "C:\Users\username \Documents\My Data Sources\Northwind.mdb Products.odc" 
 
    strName = "Data from ODC" 
 
    Set vsoDataRecordset = ThisDocument.DataRecordsets.AddFromConnectionFile(strFile, 0, strName) 
 
End Sub

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.