DataObjectFieldAttribute Klasse

Definition

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Quelle:

DataObjectFieldAttribute.cs

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 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, um Eigenschaften zur Entwurfszeit basierend auf dem verfügbar gemachten Schema festzulegen.

Sie wenden das DataObjectFieldAttribute -Attribut auf Elemente der Datenelementobjekte an, die von der Select-Methode eines mit dem DataObjectAttribute -Attribut gekennzeichneten Objekts zurückgegeben werden. Im folgenden Beispiel wird die NorthwindData -Klasse mit dem DataObjectAttribute -Attribut gekennzeichnet und gibt ein IEnumerable Objekt zurück, das GetAllEmployees Objekte der -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

DataObjectFieldAttribute(Boolean)	Initialisiert eine neue Instanz der DataObjectFieldAttribute-Klasse und gibt an, ob das Feld den Primärschlüssel für die Datenzeile darstellt.
DataObjectFieldAttribute(Boolean, Boolean)	Initialisiert eine neue Instanz der DataObjectFieldAttribute-Klasse und gibt an, ob das Feld den Primärschlüssel für die Datenzeile darstellt und ob das Feld ein Datenbank-Identitätsfeld darstellt.
DataObjectFieldAttribute(Boolean, Boolean, Boolean)	Initialisiert eine neue Instanz der DataObjectFieldAttribute-Klasse und gibt an, ob das Feld den Primärschlüssel für die Datenzeile darstellt, ob das Feld ein Datenbank-Identitätsfeld darstellt und ob das Feld NULL sein kann.
DataObjectFieldAttribute(Boolean, Boolean, Boolean, Int32)	Initialisiert eine neue Instanz der DataObjectFieldAttribute-Klasse und gibt an, ob das Feld den Primärschlüssel für die Datenzeile darstellt, ob es ein Datenbank-Identitätsfeld darstellt und ob es NULL sein kann, und legt die Länge des Felds fest.

Eigenschaften

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 Identitätsfeld darstellt, das im zugrunde liegenden Datenspeicher NULL sein kann.
Length	Ruft die Länge der Eigenschaft in Bytes ab.
PrimaryKey	Ruft einen Wert ab, der angibt, ob eine Eigenschaft im Primärschlüssel in den zugrunde liegenden Daten ist.
TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)

Methoden

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