DataObjectMethodAttribute Klasse

Definition

Namespace:

System.ComponentModel

Assembly:

System.dll

Identifiziert eine Datenvorgangsmethode, die von einem Typ verfügbar gemacht wird, welche Art von Operation die Methode ausführt, und ob die Methode die Standarddatenmethode ist. Diese Klasse kann nicht vererbt werden.

public ref class DataObjectMethodAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Method)]
public sealed class DataObjectMethodAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Method)>]
type DataObjectMethodAttribute = class
    inherit Attribute

Public NotInheritable Class DataObjectMethodAttribute
Inherits Attribute

Vererbung

Object

Attribute

DataObjectMethodAttribute

Attribute

AttributeUsageAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie das DataObjectMethodAttribute Attribut auf eine öffentlich verfügbar gemachte Methode anwenden und den Typ des von ihr ausgeführten Datenvorgangs identifizieren sowie ob es sich um die Standarddatenmethode des Typs handelt. In diesem Beispiel macht der NorthwindData Typ zwei Datenmethoden verfügbar: eine zum Abrufen einer Datenmenge namens GetAllEmployeesund eine andere zum Löschen von Daten mit dem Namen DeleteEmployeeByID. Das DataObjectMethodAttribute Attribut wird auf beide Methoden angewendet, die GetAllEmployees Methode wird als Standardmethode für den Select-Datenvorgang markiert, und die DeleteEmployeeByID Methode wird als Standardmethode für den Löschdatenvorgang markiert.

[DataObjectAttribute]
public class NorthwindData
{  
  public NorthwindData() {}

  [DataObjectMethodAttribute(DataObjectMethodType.Select, true)]
  public static IEnumerable GetAllEmployees()
  {
    AccessDataSource ads = new AccessDataSource();
    ads.DataSourceMode = SqlDataSourceMode.DataReader;
    ads.DataFile = "~//App_Data//Northwind.mdb";
    ads.SelectCommand = "SELECT EmployeeID,FirstName,LastName FROM Employees";
    return ads.Select(DataSourceSelectArguments.Empty);
  }

  // Delete the Employee by ID.
  [DataObjectMethodAttribute(DataObjectMethodType.Delete, true)]
  public void DeleteEmployeeByID(int employeeID)
  {
    throw new Exception("The value passed to the delete method is "
                         + employeeID.ToString());
  }
}

<DataObjectAttribute()> _
Public Class NorthwindData

  <DataObjectMethodAttribute(DataObjectMethodType.Select, True)> _
  Public Shared Function GetAllEmployees() As IEnumerable
    Dim ads As New AccessDataSource()
    ads.DataSourceMode = SqlDataSourceMode.DataReader
    ads.DataFile = "~/App_Data/Northwind.mdb"
    ads.SelectCommand = "SELECT EmployeeID,FirstName,LastName FROM Employees"
    Return ads.Select(DataSourceSelectArguments.Empty)
  End Function 'GetAllEmployees

  ' Delete the Employee by ID.
  <DataObjectMethodAttribute(DataObjectMethodType.Delete, True)> _
  Public Sub DeleteEmployeeByID(ByVal employeeID As Integer)
    Throw New Exception("The value passed to the delete method is " + employeeID.ToString())
  End Sub

End Class

Hinweise

Sie können die DataObjectMethodAttribute Datenvorgangsmethoden für einen Typ identifizieren, der mit dem DataObjectAttribute Attribut gekennzeichnet ist, sodass sie durch Aufrufer mithilfe der Spiegelung einfacher identifiziert werden. Wenn das DataObjectMethodAttribute Attribut auf eine Methode angewendet wird, beschreibt es den Typ des Vorgangs, den die Methode ausführt, und gibt an, ob es sich bei der Methode um die Standarddatenvorgangsmethode eines Typs handelt. Komponenten wie das ObjectDataSource Steuerelement und die ObjectDataSourceDesigner Klasse untersuchen die Werte dieses Attributs( falls vorhanden), um zu ermitteln, welche Datenmethode zur Laufzeit aufgerufen werden soll.

Konstruktoren

Name	Beschreibung
DataObjectMethodAttribute(DataObjectMethodType, Boolean)	Initialisiert eine neue Instanz der DataObjectMethodAttribute Klasse, identifiziert den Typ des von der Methode ausgeführten Datenvorgangs und gibt an, ob es sich bei der Methode um die Standarddatenmethode handelt, die das Datenobjekt verfügbar macht.
DataObjectMethodAttribute(DataObjectMethodType)	Initialisiert eine neue Instanz der DataObjectMethodAttribute Klasse und identifiziert den Typ des von der Methode ausgeführten Datenvorgangs.

Eigenschaften

Name	Beschreibung
IsDefault	Ruft einen Wert ab, der angibt, ob die Methode, auf die die DataObjectMethodAttribute angewendet wird, die Standarddatenmethode ist, die vom Datenobjekt für einen bestimmten Methodentyp verfügbar gemacht wird.
MethodType	Ruft einen DataObjectMethodType Wert ab, der den Typ des Von der Methode ausgeführten Datenvorgangs angibt.
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)	Ruft einen Wert ab, der angibt, ob diese Instanz ein gemeinsames Muster mit einem angegebenen Attribut gemeinsam verwendet.
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)