Atributo Attributes do ADO

Voltar ao Manual de Referência do Objeto Field ADO

Definição e uso

O atributo Attributes pode configurar ou retornar um valor Long, que pode indicar uma ou várias características do objeto.

Notas:Quando várias propriedades são configuradas, pode-se somar os constantes apropriados. Se o valor das propriedades for configurado para incluir a soma de constantes incompatíveis, ocorrerá um erro.

Objeto Descrição do atributo Attributes
Connection O atributo Attributes possui permissões de leitura e escrita para o objeto Connection. E seu valor pode ser um ou vários XactAttributeEnum A soma dos valores. O valor padrão é zero (0).
Parameter O atributo Attributes possui permissões de leitura e escrita para o objeto Parameter. E seu valor pode ser qualquer um ou vários ParameterAttributesEnum A soma dos valores. O valor padrão é adParamSigned.
Field Quando o atributo Attributes é usado para criar um Recordset, ele possui permissões de leitura e escrita, mas quando você abre um Recordset existente, ele é apenas leitura. O atributo Attributes pode ser um ou vários FieldAttributeEnum A soma dos valores.
Property Para o objeto Property, o atributo Attributes é apenas leitura. E seu valor pode ser qualquer um ou vários PropertyAttributesEnum A soma dos valores.

Sintaxe

object.Attributes

Instância

Para o objeto Connection:

<%
definir conn=Server.CreateObject("ADODB.Connection")
conn.Provider="Microsoft.Jet.OLEDB.4.0"
conn.Open "c:/webdata/northwind.mdb"
response.write(conn.Attributes)
conn.close
%>

Para o objeto Field:

<%
definir conn=Server.CreateObject("ADODB.Connection")
conn.Provider="Microsoft.Jet.OLEDB.4.0"
conn.Open "c:/webdata/northwind.mdb"
definir rs = Server.CreateObject("ADODB.Recordset")
rs.open "Select * from orders", conn
definir f=Server.CreateObject("ADODB.Field")
"Exibir os atributos dos campos da tabela Orders"
para cada f em rs.Fields
  response.write("Atr:" & f.Attributes & "<br />")
  response.write("Nome:" & f.Name & "<br />")
  response.write("Valor:" & f.Value & "<br />")
Next
rs.Close
conn.close
definir rs=nothing
definir conn=nothing
%>

Para o objeto Property:

<%
definir conn=Server.CreateObject("ADODB.Connection")
conn.Provider="Microsoft.Jet.OLEDB.4.0"
conn.Open "c:/webdata/northwind.mdb"
definir rs = Server.CreateObject("ADODB.Recordset")
rs.open "Select * from orders", conn
definir prop=Server.CreateObject("ADODB.Property")
"Exibir os atributos das propriedades da tabela Orders"
para cada prop em rs.Properties
  response.write("Atr:" & prop.Attributes & "<br />")
  response.write("Nome:" & prop.Name & "<br />")
  response.write("Valor:" & prop.Value & "<br />")
next
rs.close
conn.close
definir rs=nothing
definir conn=nothing
%>

Valor do enum XactAttribute

Constante Valor Descrição
adXactAbortRetaining 262144 Quando chamado RollbackTrans, é iniciada automaticamente uma nova transação.
adXactCommitRetaining 131072 O novo transação é iniciado automaticamente ao chamar CommitTrans.

Valores de ParameterAttributesEnum

Constante Valor Descrição
adParamSigned 16 Este parâmetro aceita valores assinados.
adParamNullable 64 Este parâmetro aceita valores nulos.
adParamLong 128 Este parâmetro aceita dados binários longos.

Valores de FieldAttributeEnum

Constante Valor Descrição
adFldCacheDeferred 0x1000 Indica que o provedor armazena os valores do campo e indica que é possível ler os valores armazenados.
adFldFixed 0x10 Indica que este campo contém dados de comprimento fixo.
adFldIsChapter 0x2000 Indica que este campo contém um valor de subconjunto, que especifica um subconjunto de registros específicos relacionados ao campo pai. Normalmente, o campo de subconjunto é usado em conjunto com a estrutura de dados ou o filtro de dados.
adFldIsCollection 0x40000 Este campo especifica que o recurso representado pelo registro é uma coleção de outros recursos (como uma pasta) e não apenas um recurso simples (como um arquivo de texto).
adFldIsDefaultStream 0x20000 Este campo contém o fluxo padrão do recurso representado pelo registro. Por exemplo, o fluxo padrão pode ser o conteúdo HTML da pasta raiz do site da Web, fornecido automaticamente ao especificar a URL raiz.
adFldIsNullable 0x20 Este campo aceita valores nulos.
adFldIsRowURL 0x10000 Este campo contém uma URL que nomeia o recurso no armazenamento de dados representado pelo registro.
adFldKeyColumn 0x8000 Este campo é a chave primária do conjunto básico de linhas. Também indica que este campo é parte de uma chave primária composta.
adFldLong 0x80 Este campo é um campo binário longo. Também indica que é possível usar os métodos AppendChunk e GetChunk.
adFldMayBeNull 0x40 É possível ler valores nulos a partir deste campo.
adFldMayDefer 0x2 Este campo é atrasado, ou seja, o valor deste campo não é recuperado do fonte de dados junto com o registro inteiro, mas é recuperado explicitamente ao acessá-lo.
adFldNegativeScale 0x4000 Este campo representa o valor numérico de uma coluna que suporta valores de faixa negativa. A faixa é especificada pela propriedade NumericScale.
adFldRowID 0x100 Este campo contém um identificador de persistência, que não pode ser gravado e não tem qualquer significado além da linha de identificação, por exemplo, número de registro, identificador único, etc.
adFldRowVersion 0x200 Este campo contém algum tipo de timestamp ou data para rastrear atualizações.
adFldUnknownUpdatable 0x8 O provedor não pode determinar se o usuário pode escrever no campo.
adFldUnspecified
  • -1
  • 0xFFFFFFFF
 O provedor não especificou a propriedade do campo.
adFldUpdatable 0x4 O usuário pode escrever no campo.

Valores de PropertyAttributesEnum

Constante Valor Descrição
adPropNotSupported 0 O provedor não suporta essa propriedade.
adPropRequired 1 O usuário deve especificar o valor dessa propriedade antes de inicializar o provedor de dados.
adPropOptional 2 O usuário não precisa especificar o valor dessa propriedade antes de inicializar o provedor de dados.
adPropRead 512 O usuário pode ler essa propriedade.
adPropWrite 1024 O usuário pode configurar essa propriedade.

Voltar ao Manual de Referência do Objeto Field ADO