Método Execute (RDS)
Executa a solicitação e cria um conjunto de registros ADO para uso no ADO 2.5 e posterior.
Importante
A partir do Windows 8 e do Windows Server 2012, os componentes do servidor RDS não estão mais incluídos no sistema operacional Windows (confira Windows 8 e Manual de Compatibilidade do Windows Server 2012 para obter mais detalhes). Os componentes do cliente RDS serão removidos em uma versão futura do Windows. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Os aplicativos que usam o RDS devem migrar para o Serviço de Dados do WCF.
Sintaxe
object.Execute(ConnectionString As String, HandlerString As String, QueryString As String, lFetchOptions As Long, Properties, TableId, lExecuteOptions As Long, pParameters, [lcid As Long], [pInformation])
Parâmetros
ConnectionString
Uma cadeia de caracteres usada para se conectar ao provedor OLE DB em que a solicitação será enviada para execução. Se um manipulador for especificado por meio de HandlerString, ele poderá editar ou substituir a cadeia de conexão.
HandlerString
Uma cadeia de caracteres de duas partes que identifica o manipulador a ser usado com essa execução. A cadeia de caracteres contém duas partes. A primeira parte contém o nome (ProgID) do manipulador a ser usado. A segunda parte contém os argumentos a serem transmitidos para o manipulador. Os detalhes de como a cadeia de argumentos é interpretada são específicos de cada manipulador. As duas partes são separadas pela primeira instância de uma vírgula na cadeia de caracteres. A cadeia de caracteres de argumentos pode conter vírgulas adicionais. Os argumentos são opcionais.
QueryString
Um comando na linguagem de comandos compatível com o provedor OLE DB identificado na cadeia de conexão. Para os provedores baseados em SQL, QueryString pode conter uma instrução de comando Transact-SQL, mas para os provedores não SQL (por exemplo, o MSDataShape), essa pode não ser uma instrução de consulta Transact-SQL.
Se um manipulador estiver sendo usado, o manipulador poderá alterar ou substituir o valor especificado aqui. Por exemplo, o manipulador normalmente substitui QueryString por uma cadeia de consulta do arquivo.ini. Por padrão, o arquivo Msdfmap.ini é usado.
lFetchOptions
Indica o tipo de busca assíncrona.
Para saber mais, confira Propriedade FetchOptions (RDS).
TableID
Uma Variant do tipo VT_EMPTY ou VT_BSTR. Se esse valor for do tipo VT_EMPTY, ele será ignorado. Se ele for do tipo VT_BSTR, o conjunto de registros será criado com adCmdTableDirect e o valor especificado aqui, e o parâmetro QueryString será ignorado.
lExecuteOptions
Uma máscara de bits de opções de execução:
1=ReadOnly O conjunto de registros será aberto por meio de adLockReadOnly.
2=NoBatch O conjunto de registros será aberto por meio de adLockOptimistic.
4=AllParamInfoSupplied O chamador garante que as informações de todos os parâmetros sejam fornecidas em pParameters.
8=GetInfo As informações de parâmetro da consulta serão obtidas do provedor OLE DB e retornadas no parâmetro pParameters. A consulta não é executada e nenhum conjunto de registros é retornado.
16=GetHiddenColumns O conjunto de registros será aberto por meio de adLockBatchOptimistic e todas as colunas ocultas serão incluídas no conjunto de registros.
ReadOnly, NoBatch e GetHiddenColumns são opções mutuamente exclusivas; no entanto, a definição de mais de uma delas não gera erro. Se várias opções forem definidas, GetHiddenColumns terá precedência sobre todas as outras, seguidas de ReadOnly. Se nenhuma opção for especificada, por padrão, o conjunto de registros será aberto por meio de adLockBatchOptimistic e as colunas ocultas não serão incluídas no conjunto de registros.
pParameters
Uma Variant que contém uma matriz segura de definições de parâmetro. Se a opção GetInfo for especificada em lExecuteOptions, esse parâmetro será usado para retornar as definições de parâmetro obtidas do provedor OLE DB. Caso contrário, esse parâmetro pode estar vazio.
lcid
O LCID usado para compilar os erros retornados em pInformation.
pInformation
Um ponteiro para o erro de informações retornado por Execute. Se isso for NULL, nenhuma informação de erro será retornada.
Comentários
O parâmetro HandlerString pode ser nulo. O que acontece nesse caso depende de como o servidor RDS está configurado. Uma cadeia de caracteres de manipulador de "MSDFMAP.handler" indica que o manipulador fornecido pela Microsoft (Msdfmap.dll) deve ser usado. Uma cadeia de caracteres de manipulador de "MASDFMAP.handler,sample.ini" indica que o manipulador de Msdfmap.dll deve ser usado e que o argumento "sample.ini" deve ser transmitido para o manipulador. O MSDFMAP.dll interpretará o argumento como uma instrução para usar o sample.ini a fim de verificar as cadeias de conexão e de consulta.