Freigeben über


IColumnMappingCollection-Schnittstelle

Enthält eine Auflistung von DataColumnMapping-Objekten und wird durch die DataColumnMappingCollection implementiert, die von allen .NET Framework-Datenanbietern gemeinsam verwendet wird.

Namespace: System.Data
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public Interface IColumnMappingCollection
    Inherits IList, ICollection, IEnumerable
'Usage
Dim instance As IColumnMappingCollection
public interface IColumnMappingCollection : IList, ICollection, IEnumerable
public interface class IColumnMappingCollection : IList, ICollection, IEnumerable
public interface IColumnMappingCollection extends IList, ICollection, 
    IEnumerable
public interface IColumnMappingCollection extends IList, ICollection, 
    IEnumerable

Hinweise

Die IColumnMappingCollection-Schnittstelle ermöglicht einer erbenden Klasse das Implementieren einer ColumnMapping-Auflistung. Weitere Informationen finden Sie unter Einrichten von DataTable- und DataColumn-Zuordnungen.

Eine Anwendung erstellt eine Instanz der IColumnMappingCollection-Schnittstelle nicht direkt, sondern erstellt eine Instanz einer Klasse, die IColumnMappingCollection erbt.

Klassen, die IColumnMappingCollection erben, müssen alle geerbten Member implementieren. Sie definieren i. d. R. zusätzliche Member, um anbieterspezifische Funktionen hinzuzufügen. Die IColumnMappingCollection-Schnittstelle definiert z. B. die RemoveAt-Methode. Die DataTableMappingCollection-Klasse erbt wiederum diese Methode und definiert zwei zusätzliche Überladungen von RemoveAt.

Hinweise für Implementierer Wenn Sie die IColumnMappingCollection-Schnittstelle vererben, müssen Sie den folgenden Konstruktor implementieren:

Element

Beschreibung

ColumnMappingCollection()

Erstellt eine leere ColumnMappingCollection-Klasse.

Beispiel

Im folgenden Beispiel wird eine Instanz der abgeleiteten Klasse DataTableMapping verwendet, um mehrere DataColumnMapping-Objekte der zugehörigen ColumnMappings-Auflistung mithilfe von Add hinzuzufügen. Anschließend wird eine Liste dieser zugeordneten Quelltabellen angezeigt. In diesem Beispiel wird davon ausgegangen, dass bereits eine DataTableMapping-Klasse erstellt wurde.

Public Sub ShowColumnMappings()
    ' ...
    ' create tableMapping
    ' ...
    tableMapping.ColumnMappings.Add( _
       "Category Name", "DataCategory")
    tableMapping.ColumnMappings.Add( _
       "Description", "DataDescription")
    tableMapping.ColumnMappings.Add( _
       "Picture", "DataPicture")
    Console.WriteLine("Column Mappings:")
    Dim i As Integer
    For i = 0 To tableMapping.ColumnMappings.Count - 1
        Console.WriteLine("  {0} {1}", i, _
           tableMapping.ColumnMappings(i).ToString())
    Next i
End Sub
public void ShowColumnMappings() 
{
    // ...
    // create tableMapping
    // ...
    tableMapping.ColumnMappings.Add("Category Name","DataCategory");
    tableMapping.ColumnMappings.Add("Description","DataDescription");
    tableMapping.ColumnMappings.Add("Picture","DataPicture");
    Console.WriteLine("Column Mappings");
    for(int i=0;i < tableMapping.ColumnMappings.Count;i++) 
    {
        Console.WriteLine("  {0} {1}", i,
            tableMapping.ColumnMappings[i].ToString());
    }
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

IColumnMappingCollection-Member
System.Data-Namespace