DataObjectMethodAttribute Classe

Definição

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

Herança

Object

Attribute

DataObjectMethodAttribute

Atributos

AttributeUsageAttribute

Exemplos

O exemplo de código seguinte demonstra como pode aplicar o DataObjectMethodAttribute atributo a um método exposto publicamente e identificar o tipo de operação de dados que este realiza, bem como se é o método de dados padrão do tipo. Neste exemplo, o NorthwindData tipo expõe dois métodos de dados: um para recuperar um conjunto de dados chamado GetAllEmployees, e outro para eliminar dados chamados DeleteEmployeeByID. O DataObjectMethodAttribute atributo é aplicado a ambos os métodos, o GetAllEmployees método é marcado como o método padrão para a operação Selecionar dados, e o DeleteEmployeeByID método é marcado como o método padrão para a operação Eliminar dados.

[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

Observações

Pode usar o DataObjectMethodAttribute para identificar métodos de operação de dados num tipo marcado com o DataObjectAttribute atributo, de modo a que sejam mais facilmente identificados pelos chamadores através da reflexão. Quando o DataObjectMethodAttribute atributo é aplicado a um método, descreve o tipo de operação que o método realiza e indica se o método é o método de operação de dados padrão de um tipo. Componentes como o controlo ObjectDataSource e a ObjectDataSourceDesigner classe examinam os valores deste atributo, se presentes, para ajudar a determinar qual método de dados chamar em tempo de execução.