DataObjectMethodAttribute Klasse

Definition

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Quelle:

DataObjectMethodAttribute.cs

Identifiziert die von einem Typ verfügbar gemachte Datenvorgangsmethode und gibt an, welcher Vorgangstyp von der Methode ausgeführt wird und ob die Methode die Standarddatenmethode darstellt. 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 zugängliche Methode anwenden und den Typ des ausgeführten Datenvorgangs sowie die Standarddatenmethode des Typs identifizieren können. In diesem Beispiel macht der NorthwindData Typ zwei Datenmethoden verfügbar: eine zum Abrufen eines Datensatzes mit dem Namen 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 ist als Standardmethode für den Vorgang "Daten löschen" gekennzeichnet.

[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 verwenden, um Datenvorgangsmethoden für einen typ zu identifizieren, der mit dem DataObjectAttribute -Attribut gekennzeichnet ist, sodass sie von Aufrufenden mithilfe von Reflektion leichter identifiziert werden können. Wenn das DataObjectMethodAttribute Attribut auf eine Methode angewendet wird, beschreibt es den Typ des Vorgangs, den die Methode ausführt, und gibt an, ob die Methode die Standarddatenvorgangsmethode eines Typs ist. Komponenten wie das ObjectDataSource Steuerelement und die ObjectDataSourceDesigner Klasse untersuchen die Werte dieses Attributs, sofern vorhanden, um zu bestimmen, welche Datenmethode zur Laufzeit aufgerufen werden soll.

Konstruktoren

DataObjectMethodAttribute(DataObjectMethodType)	Initialisiert eine neue Instanz der DataObjectMethodAttribute-Klasse und identifiziert den Typ des von der Methode ausgeführten Datenvorgangs.
DataObjectMethodAttribute(DataObjectMethodType, Boolean)	Initialisiert eine neue Instanz der DataObjectMethodAttribute-Klasse, identifiziert den Typ des von der Methode ausgeführten Datenvorgangs, und gibt an, ob die Methode die vom Datenobjekt verfügbar gemachte Standarddatenmethode darstellt.

Eigenschaften

IsDefault	Ruft einen Wert ab, der angibt, ob die Methode, auf die DataObjectMethodAttribute angewendet wird, die vom Datenobjekt für einen bestimmten Methodentyp verfügbar gemachte Standardwertmethode darstellt.
MethodType	Ruft einen DataObjectMethodType-Wert ab, der den Typ des von der Methode ausgeführten Datenvorgangs angibt.
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)	Ruft einen Wert ab, der angibt, ob diese Instanz ein allgemeines Muster für ein angegebenes Attribut freigibt.
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)