DataObjectFieldAttribute Classe

Definição

Fornece metadados para uma propriedade que representa um campo de dados. Esta classe não pode ser herdada.

public ref class DataObjectFieldAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Property)]
public sealed class DataObjectFieldAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.Property)>]
type DataObjectFieldAttribute = class
    inherit Attribute
Public NotInheritable Class DataObjectFieldAttribute
Inherits Attribute
Herança
DataObjectFieldAttribute
Atributos

Exemplos

O exemplo de código seguinte demonstra como pode aplicar o DataObjectFieldAttribute a uma propriedade publicamente exposta para identificar metadados associados à propriedade. Neste exemplo, o NorthwindEmployee tipo expõe três propriedades de dados: EmployeeID, FirstName, e LastName. O DataObjectFieldAttribute atributo é aplicado às três propriedades; no entanto, apenas o EmployeeID atributo de propriedade indica que é a chave principal para a linha de dados.

public class NorthwindEmployee
{
  public NorthwindEmployee() { }

  private int _employeeID;
  [DataObjectFieldAttribute(true, true, false)]
  public int EmployeeID
  {
    get { return _employeeID; }
    set { _employeeID = value; }
  }

  private string _firstName = String.Empty;
  [DataObjectFieldAttribute(false, false, true)]
  public string FirstName
  {
    get { return _firstName; }
    set { _firstName = value; }
  }

  private string _lastName = String.Empty;
  [DataObjectFieldAttribute(false, false, true)]
  public string LastName
  {
    get { return _lastName; }
    set { _lastName = value; }
  }
}
Public Class NorthwindEmployee

  Public Sub New()
  End Sub

  Private _employeeID As Integer
  <DataObjectFieldAttribute(True, True, False)> _
  Public Property EmployeeID() As Integer
    Get
      Return _employeeID
    End Get
    Set(ByVal value As Integer)
      _employeeID = value
    End Set
  End Property

  Private _firstName As String = String.Empty
  <DataObjectFieldAttribute(False, False, False)> _
  Public Property FirstName() As String
    Get
      Return _firstName
    End Get
    Set(ByVal value As String)
      _firstName = value
    End Set
  End Property

  Private _lastName As String = String.Empty
  <DataObjectFieldAttribute(False, False, False)> _
  Public Property LastName() As String
    Get
      Return _lastName
    End Get
    Set(ByVal value As String)
      _lastName = value
    End Set
  End Property

End Class

Observações

Use o DataObjectFieldAttribute atributo para fornecer informação sobre o esquema dos dados subjacentes. As classes em tempo de design, como a classe ObjectDataSourceDesigner , usam o DataObjectAttribute atributo para definir propriedades em tempo de design com base no esquema exposto.

Aplica-se o DataObjectFieldAttribute atributo aos membros dos objetos do item de dados que são devolvidos pelo método Select de um objeto marcado com o DataObjectAttribute atributo. No exemplo seguinte, a NorthwindData classe é marcada com o DataObjectAttribute atributo e devolve um IEnumerable objeto contendo NorthwindEmployee objetos do GetAllEmployees método. Os campos da NorthwindEmployee classe estão marcados com o DataObjectFieldAttribute atributo para indicar que representam campos de dados na fonte de dados subjacente.

Para mais informações sobre o uso de atributos, consulte Atributos.

Construtores

Name Description
DataObjectFieldAttribute(Boolean, Boolean, Boolean, Int32)

Inicializa uma nova instância da DataObjectFieldAttribute classe e indica se o campo é a chave primária para a linha de dados, se é um campo de identidade de base de dados e se pode ser nulo, definindo o comprimento do campo.

DataObjectFieldAttribute(Boolean, Boolean, Boolean)

Inicializa uma nova instância da DataObjectFieldAttribute classe e indica se o campo é a chave primária para a linha de dados, se o campo é um campo de identidade da base de dados e se o campo pode ser nulo.

DataObjectFieldAttribute(Boolean, Boolean)

Inicializa uma nova instância da DataObjectFieldAttribute classe e indica se o campo é a chave primária para a linha de dados e se o campo é um campo de identidade da base de dados.

DataObjectFieldAttribute(Boolean)

Inicializa uma nova instância da DataObjectFieldAttribute classe e indica se o campo é a chave primária para a linha de dados.

Propriedades

Name Description
IsIdentity

Recebe um valor que indica se uma propriedade representa um campo identidade nos dados subjacentes.

IsNullable

Obtém um valor que indica se uma propriedade representa um campo que pode ser nulo no armazenamento de dados subjacente.

Length

Obtém o comprimento da propriedade em bytes.

PrimaryKey

Obtém um valor que indica se uma propriedade está na chave primária dos dados subjacentes.

TypeId

Quando implementado numa classe derivada, obtém um identificador único para esta Attribute.

(Herdado de Attribute)

Métodos

Name Description
Equals(Object)

Devolve um valor que indica se esta instância é igual a um objeto especificado.

GetHashCode()

Devolve o código de hash para esta instância.

GetType()

Obtém o Type da instância atual.

(Herdado de Object)
IsDefaultAttribute()

Quando sobrescrito numa classe derivada, indica se o valor desta instância é o valor padrão para a classe derivada.

(Herdado de Attribute)
Match(Object)

Quando sobrescrito numa classe derivada, devolve um valor que indica se esta instância é igual a um objeto especificado.

(Herdado de Attribute)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Implementações de Interface Explícita

Name Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de despacho.

(Herdado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera a informação de tipo de um objeto, que pode ser usada para obter a informação de tipo para uma interface.

(Herdado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera o número de interfaces de informações de tipo que um objeto fornece (0 ou 1).

(Herdado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acesso a propriedades e métodos expostos por um objeto.

(Herdado de Attribute)

Aplica-se a