DataObjectMethodAttribute Classe

Definizione

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

Ereditarietà

Object

Attribute

DataObjectMethodAttribute

Attributi

AttributeUsageAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come applicare l'attributo DataObjectMethodAttribute a un metodo esposto pubblicamente e identificare il tipo di operazione di dati eseguita, nonché se si tratta del metodo dati predefinito del tipo. In questo esempio il NorthwindData tipo espone due metodi di dati: uno per recuperare un set di dati denominato e un altro per eliminare i dati denominati GetAllEmployeesDeleteEmployeeByID. L'attributo DataObjectMethodAttribute viene applicato a entrambi i metodi, il GetAllEmployees metodo viene contrassegnato come metodo predefinito per l'operazione Seleziona dati e il DeleteEmployeeByID metodo viene contrassegnato come metodo predefinito per l'operazione Elimina dati.

[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

Commenti

È possibile utilizzare DataObjectMethodAttribute per identificare i metodi di operazione dei dati in un tipo contrassegnato con l'attributo DataObjectAttribute in modo che siano più facilmente identificati dai chiamanti che usano la reflection. Quando l'attributo DataObjectMethodAttribute viene applicato a un metodo, descrive il tipo di operazione eseguita dal metodo e indica se il metodo è il metodo predefinito dell'operazione dati di un tipo. I componenti, ad esempio il ObjectDataSource controllo e la ObjectDataSourceDesigner classe, esaminano i valori di questo attributo, se presenti, per determinare quale metodo di dati chiamare in fase di esecuzione.