Objeto DataControl (RDS)

Aplica-se ao: Access 2013, Office 2013

Vincula um conjunto de registos de consulta de dados a um ou mais controlos (por exemplo, uma caixa de texto, controlo de grelha ou caixa de combinação) para apresentar os dados do Conjunto de registos numa página Web.

Sintaxe

    <OBJECT CLASSID="clsid:BD96C556-65A3-11D0-983A-00C04FC29E33" ID="DataControl"
       <PARAM NAME="Connect" VALUE="DSN=DSNName;UID=usr;PWD=pw;">
       <PARAM NAME="Server" VALUE="https://awebsrvr">
       <PARAM NAME="SQL" VALUE="QueryText">
    </OBJECT>

Comentários

A ID de classe do objeto RDS.DataControl é BD96C556-65A3-11D0-983A-00C04FC29E33.

Observação

[!OBSERVAçãO] Se você receber um erro informando que um objeto RDS.DataSpace ou RDS.DataControl não foi carregado, verifique se está usando a ID de classe correta. As IDs de classe desses objetos foram alteradas da versão 1.0 e 1.1.

Para um cenário básico, é necessário definir somente as propriedades SQL, Connect e Server do objeto RDS.DataControl, que chamará automaticamente o objeto corporativo padrão, RDSServer.DataFactory.

Todas as propriedades do RDS.DataControl são opcionais porque os objetos corporativos personalizados podem substituir sua funcionalidade.

Observação

[!OBSERVAçãO] Se você consultar vários resultados, somente o primeiro Recordset será retornado. Se forem necessárias várias definições de resultados, atribua cada uma ao próprio DataControl.

Um exemplo de uma consulta para vários resultados pode ser o seguinte: "Select * from Authors, Select * from Topics".

A adição de "DFMode=20;" à sua sequência de conexão durante o uso do objeto RDS.DataControl pode melhorar o desempenho do servidor na atualização de dados. Com essa definição, o objeto RDSServer.DataFactory do servidor usa um modo de recursos menos intensivo. No entanto, os seguintes recursos não estão disponíveis nesta configuração:

  • Uso de consultas parametrizadas.

  • Obtenção de informações de parâmetro ou de coluna antes da chamada do método Execute.

  • Definição de Transacionar Atualizações como Verdadeira.

  • Obtenção de status da linha.

  • Chamada do método Resync.

  • Atualização (de forma explícita ou automática) por meio da propriedade Update Resync.

  • Definição das propriedades Command ou Recordset.

  • Uso de adCmdTableDirect.

O objeto RDS.DataControl é executado no modo assíncronopor padrão. Se você solicitar a execução síncrona do aplicativo, defina o parâmetro ExecuteOptions igual a adcExecSync e o parâmetro FetchOptions igual a adcFetchUpFront, como mostra o exemplo a seguir.

    <OBJECT CLASSID="clsid:BD96C556-65A3-11D0-983A-00C04FC29E33" 
        ID="DataControl"
       <PARAM NAME="Connect" VALUE="DSN=DSNName;UID=usr;PWD=pw;">
       <PARAM NAME="Server" VALUE="https://awebsrvr">
       <PARAM NAME="SQL" VALUE="QueryText">
       <PARAM NAME="ExecuteOptions" VALUE="1">
       <PARAM NAME="FetchOptions" VALUE="1">
    </OBJECT>

Use um objeto RDS.DataControl para vincular os resultados de uma única consulta a um ou vários controles visuais. Por exemplo, suponha que você codificou uma consulta solicitando dados do cliente, como Nome, Residência, Local de Nascimento, Idade e Status de Prioridade. Use um único objeto RDS.DataControl para exibir o Nome, a Idade e a Região do cliente em três caixas de texto separadas; o Status de Prioridade do Cliente em uma caixa de seleção e todos os dados em um controle de grade.

Use objetos RDS.DataControl diferentes para vincular resultados de várias consultas a controles visuais diferentes. Por exemplo, suponha que você está usando uma consulta para obter informações sobre um cliente e uma segunda consulta para obter informações da mercadoria comprada pelo cliente. Você deseja exibir resultados da primeira consulta em três caixas de texto e uma caixa de seleção e os resultados da segunda consulta em um controle de grade. Se você usar o objeto corporativo padrão (RDSServer.DataFactory), será necessário fazer o seguinte:

  • Adicione dois RDS. Objetos DataControl para a sua página Web.

  • Gravar duas consultas, uma para cada propriedade SQL de dois objetos RDS.DataControl. O primeiro objeto RDS.DataControl conterá uma consulta SQL solicitando informações do cliente; o segundo conterá uma consulta solicitando uma lista de mercadorias compradas pelo cliente.

  • Em cada uma das marcas OBJECT dos controles vinculados, especifique o valor DATAFLD para definir os valores dos dados que você deseja exibir em cada controle visual.

Não existe nenhuma restrição de contagem no número de RDS. Objetos DataControl que pode incorporar através de etiquetas OBJECT numa única página Web.

Quando define o RDS. Objeto DataControl numa página Web, utilize valores de Altura e Largura não zero, como 1 (para evitar a inclusão de espaço extra).

Os componentes do cliente RDS já foram incluídos como parte do Internet Explorer 4.0; por esse motivo, não é necessário incluir um parâmetro CODEBASE na marca de objeto RDS.DataControl.

Com a Internet Explorer 4.0 ou posterior, pode vincular-se aos dados através de controlos HTML e controlos ActiveX apenas se estiverem marcados como controlos de modelo de apartamentos.

Utilizadores do Microsoft Visual Basic O RDS. O DataControl é utilizado apenas em aplicações baseadas na Web. Não é necessário um aplicativo cliente do Visual Basic.

  • Last updated on