Método CreateRecordset (RDS)
Aplica-se ao: Access 2013, Office 2013
Cria um Recordset vazio e desconectado.
Sintaxe
objeto. CreateRecordset(ColumnInfos)
Parâmetros
| Parâmetro | Descrição |
|---|---|
| Object | Uma variável de objeto que representa um objeto RDSServer.DataFactory ou RDS.DataControl. |
| ColumnsInfos | Uma matriz de atributos Variant que define cada coluna no Recordset criado. Cada definição de coluna contém uma matriz de quatro atributos obrigatórios e um atributo opcional. Em seguida, o conjunto de matrizes de coluna é agrupado em uma matriz, que define o Recordset. Para obter uma lista de atributos, consulte a tabela a seguir. |
Atributos de matriz variant
| 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) | Este 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 que seguem a vírgula decimal será truncado para três. |
Comentários
O objeto corporativo no servidor pode preencher o Recordset resultante com dados de um provedor de dados de banco de dados não-OLE, tal como um arquivo do sistema operacional que contenha cotações de ações.
A tabela a seguir lista os valores de DataTypeEnum suportados pelo método CreateRecordset. O número listado é o número de referência utilizado para definir campos.
Cada um dos tipos de dados tem comprimento fixo ou comprimento variável. Os tipos de comprimento fixo devem ser definidos com um tamanho igual a –1, porque 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 até 32767.
Para alguns dos tipos de dados variáveis, o tipo pode ser forçado para o tipo anotado na coluna Substituição. Você não verá as substituições até que o Recordset seja criado e preenchido. Em seguida, será possível verificar o tipo de dados real, se necessário.
Comprimento |
Constant |
Número |
Substituição |
|---|---|---|---|
Fixed |
adTinyInt |
16 |
|
Fixed |
adSmallInt |
2 |
|
Fixed |
adInteger |
3 |
|
Fixed |
adBigInt |
20 |
|
Fixed |
adUnsignedTinyInt |
17 |
|
Fixed |
adUnsignedSmallInt |
18 |
|
Fixed |
adUnsignedInt |
19 |
|
Fixed |
adUnsignedBigInt |
21 |
|
Fixed |
adSingle |
4 |
|
Fixed |
adDouble |
5 |
|
Fixed |
adCurrency |
6 |
|
Fixed |
adDecimal |
14 |
|
Fixed |
adNumeric |
131 |
|
Fixed |
adBoolean |
11 |
|
Fixed |
adError |
10 |
|
Fixed |
adGuid |
72 |
|
Fixed |
adDate |
7 |
|
Fixed |
adDBDate |
133 |
|
Fixed |
adDBTime |
134 |
|
Fixed |
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 |