Modelo de programação do RDS em detalhes

Aplica-se ao: Access 2013, Office 2013

O modelo de programação RDS é formado por estes elementos-chave:

• RDS. Espaço de dados
• RDSServer.DataFactory
• RDS. DataControl
• Evento

RDS. Espaço de dados

Seu aplicativo cliente deve especificar o servidor e o programa de servidor a ser chamado. Em troca, ele recebe uma referência ao programa de servidor, podendo tratá-la como se ela fosse o próprio programa de servidor.

O modelo de objeto RDS incorpora essa funcionalidade com o objeto RDS.DataSpace.

O programa de servidor é especificado com um identificador de programa, ou ProgID. O servidor usa o ProgID e o registro da máquina para localizar informações sobre o programa real a ser iniciado.

O RDS faz uma distinção internamente, dependendo se o programa do servidor está em um servidor remoto na Internet ou em uma intranet; um servidor em uma rede local; ou não em um servidor, mas em uma DLL (biblioteca de vínculo dinâmico) local. Essa distinção determina como as informações são trocadas entre o cliente e o servidor e faz uma diferença tangível no tipo de referência retornada ao seu aplicativo cliente. No entanto, do seu ponto de vista, essa distinção não tem nenhum significado especial. Tudo o que importa é que você receba uma referência de programa utilizável.

RDSServer.DataFactory

O RDS fornece um programa de servidor padrão que pode executar uma consulta SQL na fonte de dados e retornar um objeto Recordset ou usar um objeto Recordset e atualizar a fonte de dados.

O modelo de objeto RDS incorpora essa funcionalidade com o objeto RDSServer.DataFactory.

Além disso, esse objeto tem um método para criar um objeto Recordset vazio que você pode preencher programaticamente (CreateRecordset) e outro método para converter um objeto Recordset em uma cadeia de caracteres de texto para criar uma página da Web (ConvertToString).

Com o ADO, você pode substituir parte do comportamento de comando e da conexão padrão de RDSServer.DataFactory com um manipulador DataFactory e um arquivo de personalização contendo parâmetros de conexão, comando e segurança.

O programa do servidor às vezes é chamado de objeto de negócios. Você pode criar o seu próprio objeto corporativo para executar um acesso a dados complicados, verificações de validade etc. Até mesmo ao escrever um objeto corporativo personalizado, você poderá criar uma instância de um objeto RDSServer.DataFactory e usar alguns de seus métodos para executar suas próprias tarefas.

RDS. DataControl

O RDS permite combinar a funcionalidade de RDS.DataSpace e RDSServer.DataFactory, e também permite que os controles visuais utilizem facilmente o objeto Recordset retornado por uma consulta de uma fonte de dados. Para o caso mais comum, o RDS tenta ao máximo obter acesso automaticamente às informações em um servidor e exibi-las em um controle visual.

O modelo de objeto RDS incorpora essa funcionalidade com o objeto RDS.DataControl.

O RDS.DataControl possui dois aspectos. Um deles refere-se à fonte de dados. Se você definir as informações de comando e de conexão usando as propriedades Connect e SQL de RDS.DataControl, elas utilizarão o RDS.DataSpace automaticamente para criar uma referência ao objeto RDSServer.DataFactory padrão. Em seguida, RDSServer.DataFactory utilizará o valor da propriedade Connect para se conectar à fonte de dados, utilizará o valor da propriedade SQL para obter um Recordset da fonte de dados e retornará o objeto Recordset a RDS.DataControl.

O segundo aspecto refere-se à exibição das informações retornadas de Recordset em um controle visual. Você pode associar um controle visual ao RDS. DataControl (em um processo chamado associação) e obter acesso às informações no objeto Recordset associado, exibindo os resultados da consulta em uma página da Web no Microsoft Internet Explorer. Cada objeto RDS.DataControl acopla um objeto Recordset, que representa os resultados de uma única consulta, a um ou mais controles visuais (por exemplo, uma caixa de texto, uma caixa de combinação, um controle de grade etc.). É possível haver mais de um objeto RDS.DataControl em cada página. Cada objeto RDS.DataControl pode ser conectado a uma fonte de dados diferente e conter os resultados de uma consulta separada.

O objeto RDS.DataControl também possui seus próprios métodos de navegação, classificação e filtragem das linhas do objeto Recordset associado. Esses métodos são semelhantes, mas diferentes dos métodos no objeto ADO Recordset.

Eventos

O RDS oferece suporte a dois de seus próprios eventos, que são independentes do modelo de evento ADO. O evento onReadyStateChange é chamado sempre que a propriedade ReadyState de RDS.DataControl é alterada, notificando-o, quando uma operação assíncrona for concluída com êxito, encerrada ou contiver erro. O evento onError é chamado sempre que ocorre um erro, mesmo que ele ocorra durante uma operação assíncrona.