Método CreateRecordset (RDS)
Cria um conjunto de registros 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 (consulte o Windows 8 e o Windows Server 2012 Compatibility Cookbook para obter mais detalhes). Os componentes do cliente RDS serão removidos em uma versão futura do Windows. Evite usar esse recurso em um novo trabalho de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. Os aplicativos que usam RDS devem migrar para WCF Data Service.
Sintaxe
object.CreateRecordset(ColumnInfos)
Parâmetros
do objeto
Uma variável de objeto que representa um RDSServer.DataFactory ou RDS. Objeto DataControl.
ColumnsInfos
Uma matriz de atributos Variant que define cada coluna no conjunto de registros 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 | Valor booliano. |
| 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 para 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. |
Em seguida, o conjunto de matrizes de colunas é agrupado em uma matriz, que define o Recordset.
Observações
O objeto de negócios do lado do servidor pode preencher o do Recordset resultante com dados de um provedor de dados não OLE DB, como um arquivo do sistema operacional que contém aspas 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 comprimento 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 variáveis, o tipo pode ser coagido ao tipo anotado na coluna Substituição. Você não verá as substituições até que o do conjunto de registros seja criado e preenchido. Em seguida, você pode verificar o tipo de dados real, se necessário.
| Comprimento | Constante | Número | Substituição |
|---|---|---|---|
| Fixo | adTinyInt | 16 | |
| Fixo | adSmallInt | 2 | |
| Fixo | adInteger | 3 | |
| Fixo | adBigInt | 20 | |
| Fixo | adUnsignedTinyInt | 17 | |
| Fixo | adUnsignedSmallInt | 18 | |
| Fixo | adUnsignedInt | 19 | |
| Fixo | adUnsignedBigInt | 21 | |
| Fixo | adSingle | 4 | |
| Fixo | adDouble | 5 | |
| Fixo | adCurrency | 6 | |
| Fixo | adDecimal | 14 | |
| Fixo | adNumeric | 131 | |
| Fixo | adBoolean | 11 | |
| Fixo | adError | 10 | |
| Fixo | adGuid | 72 | |
| Fixo | adDate | 7 | |
| Fixo | adDBDate | 133 | |
| Fixo | adDBTime | 134 | |
| Fixo | 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)