Propriedade Attributes do ADO

Voltar ao Manual de Referência do Objeto Connection ADO

Definição e uso

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

Notas:Ao definir várias propriedades, pode-se somar os constantes apropriados. Se o valor da propriedade for configurado para incluir a soma de constantes incompatíveis, ocorrerá um erro.

Objeto Descrição da propriedade Attributes
Connection A propriedade 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 A propriedade 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 a propriedade Attributes é usada para criar um Recordset, ele possui permissões de leitura e escrita, mas quando você abre um Recordset existente, ele é apenas leitura. A propriedade Attributes pode ser uma ou várias FieldAttributeEnum A soma dos valores.
Property Para o objeto Property, a propriedade 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=nenhum
definir conn=nenhum
%>

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=nenhum
definir conn=nenhum
%>

Valor do enum XactAttribute

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

Valores ParameterAttributesEnum

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

Valores FieldAttributeEnum

Constante Valor Descrição
adFldCacheDeferred 0x1000 Indica que o provedor armazena os valores do campo em cache e indica que é possível ler o cache.
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. Geralmente, o campo de subconjunto é usado em conjunto com a estrutura de dados ou filtro de dados.
adFldIsCollection 0x40000 Este campo especifica que o recurso representado pelo registro é uma coleção de outros recursos (como pasta) e não apenas um recurso simples (como 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 Null.
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 Null valor pode ser lido a partir deste campo.
adFldMayDefer 0x2 Este campo é adiado, ou seja, o valor do campo não é retornado junto com o registro inteiro do origem de dados, mas é retornado quando eles são explicitamente acessados.
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 tempo ou datastamp 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 Connection ADO