Objeto DataControl (RDS)

Associa um Recordset de consulta de dados a um ou mais controles (por exemplo, uma caixa de texto, controle de grade ou caixa de combinação) para exibir os dados do Conjunto de Registros em uma página da Web.

Sintaxe

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

Observações

A ID da classe para o RDS. O objeto DataControl é BD96C556-65A3-11D0-983A-00C04FC29E33.

Para um cenário básico, você precisa definir apenas as propriedades SQL, Connect e Server do RDS. Objeto DataControl , que chamará automaticamente o objeto de negócios padrão, RDSServer.DataFactory.

Todas as propriedades no RDS. DataControl é opcional porque objetos de negócios personalizados podem substituir sua funcionalidade.

Adicionando "DFMode=20;" à cadeia de conexão ao usar o RDS. O objeto DataControl pode melhorar o desempenho do servidor ao atualizar dados. Com essa configuração, o objeto RDSServer.DataFactory no servidor usa um modo menos intensivo de recursos. No entanto, os seguintes recursos não estão disponíveis nesta configuração:

• Uso de consultas parametrizadas.

• Obter informações de parâmetro ou coluna antes de chamar o método Execute .

• Definindo atualizações transact como true.

• Obtendo o status da linha.

• Chamando o método Resync .

• Atualizando (explicitamente ou automaticamente) por meio da propriedade Update Resync .

• Definindo propriedades de comando ou conjunto de registros .

• Usando adCmdTableDirect.

O RDS. O objeto DataControl é executado no modo assíncrono por padrão. Se você precisar de execução síncrona para seu aplicativo, defina o parâmetro ExecuteOptions igual a adcExecSync e o parâmetro FetchOptions igual a adcFetchUpFront, conforme mostrado no exemplo a seguir.

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

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

Use rds diferentes. Objetos DataControl para vincular os resultados de várias consultas a diferentes controles visuais. Por exemplo, suponha que você use uma consulta para obter informações sobre um cliente e uma segunda consulta para obter informações sobre a mercadoria que o cliente comprou. Você deseja exibir os 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 de negócios padrão (RDSServer.DataFactory), deverá fazer o seguinte:

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

• Escreva duas consultas, uma para cada propriedade SQL dos dois RDS. Objetos DataControl . Um RDS. O objeto DataControl conterá uma consulta SQL solicitando informações do cliente; o segundo conterá uma consulta solicitando uma lista de mercadorias que o cliente comprou.

• Nas marcas OBJECT de cada controle associado, especifique o valor DATAFLD para definir os valores para os dados que você deseja exibir em cada controle visual.

Não há nenhuma restrição de contagem no número de RDS. Objetos DataControl que você pode inserir usando marcas OBJECT em uma única página da Web.

Quando você define o RDS. Objeto DataControl em uma página da Web, use valores de altura e largura diferentes de zero, como 1 (para evitar a inclusão de espaço extra).

Os componentes do cliente do Serviço de Dados Remoto já estão incluídos como parte do Internet Explorer 4.0; portanto, você não precisa incluir um parâmetro CODEBASE em seu RDS. Marca de objeto DataControl .

Com o Internet Explorer 4.0 ou posterior, você pode associar a dados usando controles HTML e controles ActiveX somente se eles estiverem marcados como controles de modelo de apartamento.

Esta seção contém o tópico a seguir.

• Propriedades, métodos e eventos do objeto DataControl (RDS)

Consulte Também

Exemplo do objeto DataControl (VBScript)