DataObjectFieldAttribute Classe

Definizione

Fornisce metadati per una proprietà che rappresenta un campo dati. La classe non può essere ereditata.

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
Ereditarietà
DataObjectFieldAttribute
Attributi

Esempio

Nell'esempio di codice seguente viene illustrato come applicare a DataObjectFieldAttribute una proprietà esposta pubblicamente per identificare i metadati associati alla proprietà . In questo esempio il NorthwindEmployee tipo espone tre proprietà di dati: EmployeeID, FirstNamee LastName. L'attributo DataObjectFieldAttribute viene applicato a tutte e tre le proprietà, ma solo l'attributo EmployeeID della proprietà indica che è la chiave primaria per la riga di dati.

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

Commenti

Usare l'attributo DataObjectFieldAttribute per fornire informazioni sullo schema dei dati sottostanti. Le classi in fase di progettazione, ad esempio la ObjectDataSourceDesigner classe , usano l'attributo DataObjectAttribute per impostare le proprietà in fase di progettazione in base allo schema esposto.

Si applica l'attributo DataObjectFieldAttribute ai membri degli oggetti elemento di dati restituiti dal metodo Select di un oggetto contrassegnato con l'attributo DataObjectAttribute . Nell'esempio seguente la NorthwindData classe è contrassegnata con l'attributo DataObjectAttribute e restituisce un IEnumerable oggetto contenente NorthwindEmployee oggetti dal GetAllEmployees metodo . I campi nella NorthwindEmployee classe sono contrassegnati con l'attributo DataObjectFieldAttribute per indicare che rappresentano i campi dati nell'origine dati sottostante.

Per altre informazioni sull'uso degli attributi, vedere Attributi.

Costruttori

Nome Descrizione
DataObjectFieldAttribute(Boolean, Boolean, Boolean, Int32)

Inizializza una nuova istanza della DataObjectFieldAttribute classe e indica se il campo è la chiave primaria per la riga di dati, se si tratta di un campo identity del database e se può essere Null e imposta la lunghezza del campo.

DataObjectFieldAttribute(Boolean, Boolean, Boolean)

Inizializza una nuova istanza della DataObjectFieldAttribute classe e indica se il campo è la chiave primaria per la riga di dati, se il campo è un campo identity del database e se il campo può essere Null.

DataObjectFieldAttribute(Boolean, Boolean)

Inizializza una nuova istanza della DataObjectFieldAttribute classe e indica se il campo è la chiave primaria per la riga di dati e se il campo è un campo identity del database.

DataObjectFieldAttribute(Boolean)

Inizializza una nuova istanza della DataObjectFieldAttribute classe e indica se il campo è la chiave primaria per la riga di dati.

Proprietà

Nome Descrizione
IsIdentity

Ottiene un valore che indica se una proprietà rappresenta un campo Identity nei dati sottostanti.

IsNullable

Ottiene un valore che indica se una proprietà rappresenta un campo che può essere Null nell'archivio dati sottostante.

Length

Ottiene la lunghezza della proprietà in byte.

PrimaryKey

Ottiene un valore che indica se una proprietà si trova nella chiave primaria nei dati sottostanti.

TypeId

Se implementato in una classe derivata, ottiene un identificatore univoco per questo Attribute.

(Ereditato da Attribute)

Metodi

Nome Descrizione
Equals(Object)

Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.

GetHashCode()

Restituisce il codice hash per questa istanza.

GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
IsDefaultAttribute()

Quando sottoposto a override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata.

(Ereditato da Attribute)
Match(Object)

Quando sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.

(Ereditato da Attribute)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

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

Esegue il mapping di un set di nomi a un set corrispondente di identificatori dispatch.

(Ereditato da Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera le informazioni sul tipo per un oggetto, che può essere utilizzato per ottenere le informazioni sul tipo per un'interfaccia.

(Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera il numero di interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).

(Ereditato da Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso alle proprietà e ai metodi esposti da un oggetto .

(Ereditato da Attribute)

Si applica a