DataObjectFieldAttribute Classe

Definição

Fornece metadados para uma propriedade representando um campo de dados. Essa 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 a seguir demonstra como você pode aplicar a DataObjectFieldAttribute uma propriedade exposta publicamente para identificar metadados associados à propriedade. Neste exemplo, o NorthwindEmployee tipo expõe três propriedades de dados: EmployeeID, FirstNamee LastName. O DataObjectFieldAttribute atributo é aplicado às três propriedades; no entanto, apenas o EmployeeID atributo de propriedade indica que ele é a chave primária 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

Comentários

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

Você aplica o DataObjectFieldAttribute atributo aos membros dos objetos de item de dados que são retornados pelo método Select de um objeto marcado com o DataObjectAttribute atributo. No exemplo a seguir, a NorthwindData classe é marcada com o DataObjectAttribute atributo e retorna um IEnumerable objeto que NorthwindEmployee contém objetos do GetAllEmployees método. Os campos na NorthwindEmployee classe são marcados com o DataObjectFieldAttribute atributo para indicar que representam campos de dados na fonte de dados subjacente.

Para obter mais informações sobre como usar atributos, consulte Atributos.

Construtores

DataObjectFieldAttribute(Boolean)

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

DataObjectFieldAttribute(Boolean, Boolean)

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

DataObjectFieldAttribute(Boolean, Boolean, Boolean)

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

DataObjectFieldAttribute(Boolean, Boolean, Boolean, Int32)

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

Propriedades

IsIdentity

Obtém um valor que indica se uma propriedade representa um campo de 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 tamanho da propriedade em bytes.

PrimaryKey

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

TypeId

Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute.

(Herdado de Attribute)

Métodos

Equals(Object)

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

GetHashCode()

Retorna o código hash para a instância.

GetType()

Obtém o Type da instância atual.

(Herdado de Object)
IsDefaultAttribute()

Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada.

(Herdado de Attribute)
Match(Object)

Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado.

(Herdado de Attribute)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Implantações explícitas de interface

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

Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de expedição.

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

Recupera as informações de tipo para um objeto, que pode ser usado para obter as informações de tipo para uma interface.

(Herdado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)

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

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

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

(Herdado de Attribute)

Aplica-se a