Método CreateRecordset (RDS)
Cria um Recordset vazio e desconectado.
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.CreateRecordset(ColumnInfos)
Parâmetros
Objeto
Uma variável de objeto que representa um objeto RDSServer.DataFactory ou RDS.DataControl.
ColumnsInfos
Uma matriz Variant de atributos que define cada coluna no Recordset criado. Cada definição de coluna contém uma matriz de quatro atributos necessários e um atributo opcional.
| Atributo | Descrição |
|---|---|
| Nome | Nome do cabeçalho da coluna. |
| Tipo | Inteiro do tipo de dados. |
| Tamanho | Inteiro da largura em caracteres, independentemente do tipo de dados. |
| Nulidade | $True. |
| Escala (opcional) | Esse atributo opcional define a escala para campos numéricos. Se esse valor não for especificado, os valores numéricos serão truncados em uma escala de três. A precisão não é afetada, mas o número de dígitos após o ponto decimal será truncado para três. |
O conjunto de matrizes de colunas é agrupado em uma matriz, que define o Recordset.
Comentários
O objeto de negócios do lado do servidor pode preencher o Recordset resultante com dados de um provedor de dados não OLE DB, como um arquivo do sistema operacional que contém cotações de ações.
A tabela a seguir lista os valores DataTypeEnum compatíveis com o método CreateRecordset. O número listado é o número de referência usado para definir campos.
Cada um dos tipos de dados tem comprimento fixo ou variável. Tipos de comprimento fixo devem ser definidos com um tamanho de -1, pois o tamanho é predeterminado e uma definição de tamanho ainda é necessária. Os tipos de dados de comprimento variável permitem um tamanho de 1 a 32767.
Para alguns dos tipos de dados de variáveis, o tipo pode ser imposto ao tipo anotado na coluna Substituição. Você não verá as substituições até que o Recordset seja criado e preenchido. Em seguida, você pode verificar o tipo de dados real, se necessário.
| Comprimento | Constante | Número | Substituição |
|---|---|---|---|
| Correção | adTinyInt | 16 | |
| Correção | adSmallInt | 2 | |
| Correção | adInteger | 3 | |
| Correção | adBigInt | 20 | |
| Correção | adUnsignedTinyInt | 17 | |
| Correção | adUnsignedSmallInt | 18 | |
| Correção | adUnsignedInt | 19 | |
| Correção | adUnsignedBigInt | 21 | |
| Correção | adSingle | 4 | |
| Correção | adDouble | 5 | |
| Correção | adCurrency | 6 | |
| Correção | adDecimal | 14 | |
| Correção | adNumeric | 131 | |
| Correção | adBoolean | 11 | |
| Correção | adError | 10 | |
| Correção | adGuid | 72 | |
| Correção | adDate | 7 | |
| Correção | adDBDate | 133 | |
| Correção | adDBTime | 134 | |
| Correção | adDBTimestamp | 135 | 7 |
| Variável | adBSTR | 8 | 130 |
| Variável | adChar | 129 | 200 |
| Variável | adVarChar | 200 | |
| Variável | adLongVarChar | 201 | 200 |
| Variável | adWChar | 130 | |
| Variável | adVarWChar | 202 | 130 |
| Variável | adLongVarWChar | 203 | 130 |
| Variável | adBinary | 128 | |
| Variável | adVarBinary | 204 | |
| Variável | adLongVarBinary | 205 | 204 |
Aplica-se A
Consulte Também
Exemplo do método CreateRecordset (VB)
Exemplo do método CreateRecordset (VBScript)
Método CreateObject (RDS)