DataObjectFieldAttribute Klasse

Definition

Namespace:

System.ComponentModel

Assembly:

System.dll

Stellt Metadaten für eine Eigenschaft bereit, die ein Datenfeld darstellt. Diese Klasse kann nicht vererbt werden.

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

Vererbung

Object

Attribute

DataObjectFieldAttribute

Attribute

AttributeUsageAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die DataObjectFieldAttribute Eigenschaft auf eine öffentlich verfügbar gemachte Eigenschaft anwenden können, um Metadaten zu identifizieren, die der Eigenschaft zugeordnet sind. In diesem Beispiel macht der NorthwindEmployee Typ drei Dateneigenschaften verfügbar: EmployeeID, , FirstNameund LastName. Das DataObjectFieldAttribute Attribut wird auf alle drei Eigenschaften angewendet. Allerdings gibt nur das EmployeeID Eigenschaftsattribut an, dass es der Primärschlüssel für die Datenzeile ist.

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

Hinweise

Verwenden Sie das DataObjectFieldAttribute Attribut, um Informationen zum Schema der zugrunde liegenden Daten bereitzustellen. Entwurfszeitklassen wie die ObjectDataSourceDesigner Klasse verwenden das DataObjectAttribute Attribut zum Festlegen von Eigenschaften zur Entwurfszeit basierend auf dem verfügbar gemachten Schema.

Sie wenden das DataObjectFieldAttribute Attribut auf Elemente der Datenelementobjekte an, die von der Select-Methode eines Objekts zurückgegeben werden, das mit dem DataObjectAttribute Attribut gekennzeichnet ist. Im folgenden Beispiel wird die NorthwindData Klasse mit dem DataObjectAttribute Attribut gekennzeichnet und gibt ein IEnumerable Objekt zurück, das Objekte aus der GetAllEmployees Methode enthältNorthwindEmployee. Felder in der NorthwindEmployee Klasse werden mit dem DataObjectFieldAttribute Attribut gekennzeichnet, um anzugeben, dass sie Datenfelder in der zugrunde liegenden Datenquelle darstellen.

Weitere Informationen zur Verwendung von Attributen finden Sie unter "Attribute".

Konstruktoren

Name	Beschreibung
DataObjectFieldAttribute(Boolean, Boolean, Boolean, Int32)	Initialisiert eine neue Instanz der DataObjectFieldAttribute Klasse und gibt an, ob das Feld der Primärschlüssel für die Datenzeile ist, ob es sich um ein Datenbankidentitätsfeld handelt und ob es null sein kann, und legt die Länge des Felds fest.
DataObjectFieldAttribute(Boolean, Boolean, Boolean)	Initialisiert eine neue Instanz der DataObjectFieldAttribute Klasse und gibt an, ob das Feld der Primärschlüssel für die Datenzeile ist, ob das Feld ein Datenbankidentitätsfeld ist und ob das Feld null sein kann.
DataObjectFieldAttribute(Boolean, Boolean)	Initialisiert eine neue Instanz der DataObjectFieldAttribute Klasse und gibt an, ob das Feld der Primärschlüssel für die Datenzeile ist und ob es sich bei dem Feld um ein Datenbankidentitätsfeld handelt.
DataObjectFieldAttribute(Boolean)	Initialisiert eine neue Instanz der DataObjectFieldAttribute Klasse und gibt an, ob das Feld der Primärschlüssel für die Datenzeile ist.

Eigenschaften

Name	Beschreibung
IsIdentity	Ruft einen Wert ab, der angibt, ob eine Eigenschaft ein Identitätsfeld in den zugrunde liegenden Daten darstellt.
IsNullable	Ruft einen Wert ab, der angibt, ob eine Eigenschaft ein Feld darstellt, das null im zugrunde liegenden Datenspeicher sein kann.
Length	Ruft die Länge der Eigenschaft in Bytes ab.
PrimaryKey	Ruft einen Wert ab, der angibt, ob sich eine Eigenschaft im Primärschlüssel in den zugrunde liegenden Daten befindet.
TypeId	Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ein eindeutiger Bezeichner für diese Attribute. (Geerbt von Attribute)

Methoden

Name	Beschreibung
Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz einem angegebenen Objekt entspricht.
GetHashCode()	Gibt den Hashcode für diese Instanz zurück.
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Wenn sie in einer abgeleiteten Klasse überschrieben wird, gibt an, ob der Wert dieser Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem angegebenen Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Ruft die Typinformationen für ein Objekt ab, mit denen die Typinformationen für eine Schnittstelle abgerufen werden können. (Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Bietet Zugriff auf Eigenschaften und Methoden, die von einem Objekt verfügbar gemacht werden. (Geerbt von Attribute)