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

Objeto DataControl (RDS)

Objeto DataFactory (RDSServer)

Consulte Também

Exemplo do método CreateRecordset (VB)
Exemplo do método CreateRecordset (VBScript)
Método CreateObject (RDS)