DataObjectFieldAttribute Classe

Definizione

Spazio dei nomi:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Origine:

DataObjectFieldAttribute.cs

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à

Object

Attribute

DataObjectFieldAttribute

Attributi

AttributeUsageAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come applicare l'oggetto DataObjectFieldAttribute a una proprietà esposta pubblicamente per identificare i metadati associati alla proprietà. In questo esempio il NorthwindEmployee tipo espone tre proprietà dati: EmployeeID, FirstNamee LastName. L'attributo DataObjectFieldAttribute viene applicato a tutte e tre le proprietà. Tuttavia, 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 della NorthwindEmployee classe sono contrassegnati con l'attributo per indicare che rappresentano i campi dati nell'origine DataObjectFieldAttribute dati sottostante.

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

Costruttori

DataObjectFieldAttribute(Boolean)	Inizializza una nuova istanza della classe DataObjectFieldAttribute e indica se il campo è la chiave primaria della riga di dati.
DataObjectFieldAttribute(Boolean, Boolean)	Inizializza una nuova istanza della classe DataObjectFieldAttribute e indica se il campo è la chiave primaria della riga di dati e se il campo è un campo di identità del database.
DataObjectFieldAttribute(Boolean, Boolean, Boolean)	Inizializza una nuova istanza della classe DataObjectFieldAttribute e indica se il campo è la chiave primaria della riga di dati e se il campo è un campo di identità del database e se il campo può essere null.
DataObjectFieldAttribute(Boolean, Boolean, Boolean, Int32)	Inizializza un nuova istanza della classe DataObjectFieldAttribute e indica se il campo è la chiave primaria della riga di dati, se si tratta di un campo di identità del database e se può essere null e se imposta la lunghezza del campo.

Proprietà

IsIdentity	Ottiene un valore che indica se una proprietà rappresenta un campo di identità dei 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 in byte della proprietà.
PrimaryKey	Ottiene un valore che indica se una proprietà è la chiave primaria nei dati sottostanti.
TypeId	Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute. (Ereditato da Attribute)

Metodi

Equals(Object)	Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.
GetHashCode()	Restituisce il codice hash per l'istanza.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsDefaultAttribute()	In caso di 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 equivale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)