Freigeben über

Implementieren eines DataAdapters

Wenn Sie alle .NET Framework-Datenproviderschnittstellen implementieren, ist für die Implementierung des DataAdapters eine minimale Codierung erforderlich, weil die System.Data.Common.DbDataAdapter-Klasse die Implementierung zum größten Teil enthält.

So verwenden Sie "DbDataAdapter"

  1. Stellen Sie die Implementierungen von IDbConnection, IDbCommand, IDataReader usw. zur Verfügung. Die DbDataAdapter-Klasse nutzt diese Komponenten bei der Implementierung.

  2. Erstellen Sie eine Klasse, die von DbDataAdapter und IDbDataAdapter erbt. Beispiel:

    Public Class TemplateDataAdapter
  Inherits DbDataAdapter
  Implements IDbDataAdapter
End Class
[C#]
public class TemplateDataAdapter : DbDataAdapter, IDbDataAdapter
{
}

  3. Implementieren Sie die IDbDataAdapter-Schnittstelle, und stellen Sie Eigenschaften- und Methodenimplementierungen zur Verfügung, die die "strikte Typbindung" enthalten. Somit können Benutzer des .NET Framework-Datenproviders direkt auf Objekte verweisen, die Sie zur Verfügung stellen, und müssen dafür keine Schnittstellen wie IDbCommand verwenden.

    Im folgenden Beispiel wird eine SelectCommand-Eigenschaft gezeigt, die einen TemplateCommand mit strikter Typbindung zurückgibt. Die TemplateDataAdapter.SelectCommand-Eigenschaft gibt einen IDbCommand zurück, wenn TemplateDataAdapter in IDbDataAdapter umgewandelt wird.

    Private m_selectCommand As TemplateCommand

Property IDbDataAdapterSelectCommand As IDbCommand Implements IDbDataAdapter.SelectCommand
  Get
    Return m_selectCommand
  End Get
  Set
    m_selectCommand = CType(value, TemplateCommand)
  End Set
End Property

Public Property SelectCommand As TemplateCommand
  Get
    Return m_selectCommand
  End Get
  Set
    m_selectCommand = value
  End Set
End Property
[C#]
private TemplateCommand m_selectCommand;

public TemplateCommand SelectCommand 
{
  get { return m_selectCommand; }
  set { m_selectCommand = value; }
}

IDbCommand IDbDataAdapter.SelectCommand 
{
  get { return m_selectCommand; }
  set { m_selectCommand = (TemplateCommand)value; }
}

  4. Implementieren Sie providerspezifische Versionen von RowUpdatedEventArgs und RowUpdatingEventArgs sowie verknüpfte Ereignishandlertypen (hierbei handelt es sich um Codeschablonen). Die überladenen Ereignistypen liefern außerdem strikte Typbindung. Somit können das Ereignisobjekt sowie die entsprechenden Eigenschaften (wie die Command-Eigenschaft) mit strikter Typbindung verfügbar gemacht werden. Beispiel:

    Public Class TemplateRowUpdatingEventArgs
  Inherits RowUpdatingEventArgs

  Public Sub New(row As DataRow, command As IDbCommand, statementType As StatementType, tableMapping As DataTableMapping)
                 MyBase.New(row, command, statementType, tableMapping)
  End Sub

  ' Hide the inherited implementation of the command property.
  Public Shadows Property Command As TemplateCommand
    Get
      Return CType(MyBase.Command, TemplateCommand)
    End Get
    Set
      MyBase.Command = value
    End Set
  End Property
End Class

Public Class TemplateRowUpdatedEventArgs
  Inherits RowUpdatedEventArgs

  Public Sub New(row As DataRow, command As IDbCommand, statementType As StatementType, tableMapping As DataTableMapping)
    MyBase.New(row, command, statementType, tableMapping) 
  End Sub

  ' Hide the inherited implementation of the command property.
  Public Shadows ReadOnly Property Command As TemplateCommand 
    Get
      Return CType(MyBase.Command, TemplateCommand)
    End Get
  End Property
End Class
[C#]
public class TemplateRowUpdatingEventArgs : RowUpdatingEventArgs
{
  public TemplateRowUpdatingEventArgs(DataRow row, IDbCommand command, StatementType statementType, DataTableMapping tableMapping) 
    : base(row, command, statementType, tableMapping) 
  {
  }

  // Hide the inherited implementation of the command property.
  new public TemplateCommand Command
  {
    get  { return (TemplateCommand)base.Command; }
    set  { base.Command = value; }
  }
}

public class TemplateRowUpdatedEventArgs : RowUpdatedEventArgs
{
  public TemplateRowUpdatedEventArgs(DataRow row, IDbCommand command, StatementType statementType, DataTableMapping tableMapping)
    : base(row, command, statementType, tableMapping) 
  {
  }

  // Hide the inherited implementation of the command property.
  new public TemplateCommand Command
  {
    get  { return (TemplateCommand)base.Command; }
  }
}

  5. Implementieren Sie die abstrakten Methoden von DbDataAdapter. Beispiel:

    Protected Overrides Function CreateRowUpdatedEvent(dataRow As DataRow, command As IDbCommand, statementType As StatementType, tableMapping As DataTableMapping) As RowUpdatedEventArgs
  Return New TemplateRowUpdatedEventArgs(dataRow, command, statementType, tableMapping)
End Function

Protected Overrides Function CreateRowUpdatingEvent(dataRow As DataRow, command As IDbCommand, statementType As StatementType, tableMapping As DataTableMapping) As RowUpdatingEventArgs
  Return New TemplateRowUpdatingEventArgs(dataRow, command, statementType, tableMapping)
End Function

Protected Overrides Sub OnRowUpdating(value As RowUpdatingEventArgs)
  Dim handler As TemplateRowUpdatingEventHandler  = CType(Events(EventRowUpdating), TemplateRowUpdatingEventHandler)
  If Not handler Is Nothing And value.GetType() Is Type.GetType("TemplateRowUpdatingEventArgs") Then 
    handler(Me, CType(value, TemplateRowUpdatingEventArgs))
  End If
End Sub

Protected Overrides Sub OnRowUpdated(value As RowUpdatedEventArgs)
  Dim handler As TemplateRowUpdatedEventHandler  = CType(Events(EventRowUpdated), TemplateRowUpdatedEventHandler)
  If Not handler Is Nothing And value.GetType() Is Type.GetType("TemplateRowUpdatedEventArgs") Then 
    handler(Me, CType(value, TemplateRowUpdatedEventArgs))
  End If
End Sub
[C#]
override protected RowUpdatedEventArgs CreateRowUpdatedEvent(DataRow dataRow, IDbCommand command, StatementType statementType, DataTableMapping tableMapping)
{
  return new TemplateRowUpdatedEventArgs(dataRow, command, statementType, tableMapping);
}

override protected RowUpdatingEventArgs CreateRowUpdatingEvent(DataRow dataRow, IDbCommand command, StatementType statementType, DataTableMapping tableMapping)
{
  return new TemplateRowUpdatingEventArgs(dataRow, command, statementType, tableMapping);
}

override protected void OnRowUpdating(RowUpdatingEventArgs value)
{
  TemplateRowUpdatingEventHandler handler = (TemplateRowUpdatingEventHandler) Events[EventRowUpdating];
  if ((null != handler) && (value is TemplateRowUpdatingEventArgs)) 
  {
    handler(this, (TemplateRowUpdatingEventArgs) value);
  }
}

override protected void OnRowUpdated(RowUpdatedEventArgs value)
{
  TemplateRowUpdatedEventHandler handler = (TemplateRowUpdatedEventHandler) Events[EventRowUpdated];
  if ((null != handler) && (value is TemplateRowUpdatedEventArgs)) 
  {
    handler(this, (TemplateRowUpdatedEventArgs) value);
  }
}

  6. Beenden Sie die Implementierung von Ereignissen für von DbDataAdapter abgeleitete Klassen wie im folgenden Beispiel. Beachten Sie, dass die Ereignisse Teil der TemplateDataAdapter-Klasse und die Delegaten Teil des Namespaces sind.

    Public Event RowUpdating As TemplateRowUpdatingEventHandler 
Public Event RowUpdated As TemplateRowUpdatedEventHandler 

Public Delegate Sub TemplateRowUpdatingEventHandler(sender As Object, e As TemplateRowUpdatingEventArgs)
Public Delegate Sub TemplateRowUpdatedEventHandler(sender As Object, e As TemplateRowUpdatedEventArgs)
[C#]
public event TemplateRowUpdatingEventHandler RowUpdating
{
  add { Events.AddHandler(EventRowUpdating, value); }
  remove { Events.RemoveHandler(EventRowUpdating, value); }
}

public event TemplateRowUpdatedEventHandler RowUpdated
{
  add { Events.AddHandler(EventRowUpdated, value); }
  remove { Events.RemoveHandler(EventRowUpdated, value); }
}

public delegate void TemplateRowUpdatingEventHandler(object sender, TemplateRowUpdatingEventArgs e);
public delegate void TemplateRowUpdatedEventHandler(object sender, TemplateRowUpdatedEventArgs e);

Die folgenden Themen enthalten Beispielcode für eine Implementierung eines DataAdapter-Objekts.

Beispielimplementierung in Visual Basic:

Beispielimplementierung in C#:

Siehe auch

Implementieren eines .NET Framework-Datenproviders | Beispiel für einen .NET Framework-Datenprovider

  • Last updated on