DataObjectFieldAttribute Osztály

Definíció

Névtér:

System.ComponentModel

Szerelvények:

netstandard.dll, System.ComponentModel.TypeConverter.dll

Forrás:

DataObjectFieldAttribute.cs

Metaadatokat biztosít egy adatmezőt képviselő tulajdonsághoz. Ez az osztály nem örökölhető.

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

Öröklődés

Object

Attribute

DataObjectFieldAttribute

Attribútumok

AttributeUsageAttribute

Példák

Az alábbi példakód bemutatja, hogyan alkalmazhatja a DataObjectFieldAttribute tulajdonságot egy nyilvánosan közzétett tulajdonságra a tulajdonsághoz társított metaadatok azonosításához. Ebben a példában a NorthwindEmployee típus három adattulajdonságnak tesz elérhetővé: EmployeeID, FirstNameés LastName. Az DataObjectFieldAttribute attribútum mindhárom tulajdonságra vonatkozik, azonban csak a EmployeeID tulajdonságattribútum jelzi, hogy ez az adatsor elsődleges kulcsa.

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

Megjegyzések

DataObjectFieldAttribute Az attribútum használatával információkat adhat meg az alapul szolgáló adatok sémájáról. Az olyan tervezési idejű osztályok, mint például az ObjectDataSourceDesigner osztály, az DataObjectAttribute attribútum használatával a tulajdonságokat tervezési időben, a közzétett séma alapján állítják be.

Alkalmazza az DataObjectFieldAttribute attribútumot az adatelem-objektumok azon tagjaira, amelyeket az attribútummal DataObjectAttribute megjelölt objektum Select metódusa ad vissza. Az alábbi példában az NorthwindData osztály az attribútummal DataObjectAttribute van megjelölve, és visszaad egy IEnumerable objektumot, amely NorthwindEmployee a GetAllEmployees metódusból származó objektumokat tartalmaz. Az osztály mezői NorthwindEmployee az DataObjectFieldAttribute attribútummal vannak megjelölve, hogy azok az alapul szolgáló adatforrás adatmezőit jelölik.

Az attribútumok használatáról további információt az Attribútumok című témakörben talál.

Konstruktorok

Name	Description
DataObjectFieldAttribute(Boolean, Boolean, Boolean, Int32)	Inicializálja az DataObjectFieldAttribute osztály új példányát, és jelzi, hogy a mező az adatsor elsődleges kulcsa-e, adatbázis-identitásmező-e, és hogy null értékű lehet-e, és beállítja-e a mező hosszát.
DataObjectFieldAttribute(Boolean, Boolean, Boolean)	Inicializálja az DataObjectFieldAttribute osztály új példányát, és jelzi, hogy a mező az adatsor elsődleges kulcsa-e, hogy a mező adatbázis-identitásmező-e, és hogy a mező null értékű lehet-e.
DataObjectFieldAttribute(Boolean, Boolean)	Inicializálja az DataObjectFieldAttribute osztály új példányát, és jelzi, hogy a mező az adatsor elsődleges kulcsa-e, és hogy a mező adatbázis-identitásmező-e.
DataObjectFieldAttribute(Boolean)	Inicializálja az DataObjectFieldAttribute osztály új példányát, és jelzi, hogy a mező-e az adatsor elsődleges kulcsa.

Tulajdonságok

Name	Description
IsIdentity	Beolvas egy értéket, amely jelzi, hogy egy tulajdonság egy identitásmezőt jelöl-e az alapul szolgáló adatokban.
IsNullable	Beolvas egy értéket, amely jelzi, hogy egy tulajdonság null értékű mezőt jelöl-e az alapul szolgáló adattárban.
Length	Bájtban lekéri a tulajdonság hosszát.
PrimaryKey	Beolvas egy értéket, amely jelzi, hogy egy tulajdonság szerepel-e az alapul szolgáló adatok elsődleges kulcsában.
TypeId	Ha származtatott osztályban implementálják, ehhez egy egyedi azonosítót Attributekap. (Öröklődés forrása Attribute)

Metódusok

Name	Description
Equals(Object)	Egy értéket ad vissza, amely jelzi, hogy ez a példány egyenlő-e egy adott objektummal.
GetHashCode()	A példány kivonatkódját adja vissza.
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
IsDefaultAttribute()	Ha egy származtatott osztályban felül van bírálva, azt jelzi, hogy a példány értéke-e a származtatott osztály alapértelmezett értéke. (Öröklődés forrása Attribute)
Match(Object)	Származtatott osztály felülírásakor egy olyan értéket ad vissza, amely jelzi, hogy ez a példány egy adott objektummal egyenlő-e. (Öröklődés forrása Attribute)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)