IColumnMappingCollection Schnittstelle

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

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

public interface class IColumnMappingCollection : System::Collections::IList

public interface IColumnMappingCollection : System.Collections.IList

type IColumnMappingCollection = interface
    interface ICollection
    interface IEnumerable
    interface IList

Public Interface IColumnMappingCollection
Implements IList

Abgeleitet

System.Data.Common.DataColumnMappingCollection

Implementiert

ICollection IEnumerable IList

Beispiele

Im folgenden Beispiel wird eine instance der abgeleiteten Klasse ( DataTableMapping) für Add mehrere DataColumnMapping Objekte der ColumnMappings Auflistung verwendet, und anschließend wird eine Liste der zugeordneten Quelltabellen angezeigt. In diesem Beispiel wird davon ausgegangen, dass bereits ein DataTableMapping erstellt wurde.

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());
    }
}

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

Hinweise

Die IColumnMappingCollection -Schnittstelle ermöglicht es einer erbenden Klasse, eine ColumnMapping-Auflistung zu implementieren. Weitere Informationen finden Sie unter DataAdapter DataTable- und DataColumn-Zuordnungen.

Eine Anwendung erstellt nicht direkt eine instance der IColumnMappingCollection Schnittstelle, sondern eine instance einer Klasse, die erbtIColumnMappingCollection.

Klassen, die erben IColumnMappingCollection , müssen alle geerbten Member implementieren und in der Regel zusätzliche Member definieren, um anbieterspezifische Funktionen hinzuzufügen. Beispielsweise definiert die IColumnMappingCollection -Schnittstelle die RemoveAt -Methode. Die -Klasse wiederum DataTableMappingCollection erbt diese Methode und definiert zwei zusätzliche Überladungen von RemoveAt.

Hinweise für Ausführende

Wenn Sie von der IColumnMappingCollection -Schnittstelle erben, sollten Sie den folgenden Konstruktor implementieren:

Element	Beschreibung
ColumnMappingCollection()	Erstellt eine leere ColumnMappingCollection-Klasse.

Eigenschaften

Count	Ruft die Anzahl der Elemente ab, die in ICollection enthalten sind. (Geerbt von ICollection)
IsFixedSize	Ruft einen Wert ab, der angibt, ob das IList eine feste Größe aufweist. (Geerbt von IList)
IsReadOnly	Ruft einen Wert ab, der angibt, ob das IList schreibgeschützt ist. (Geerbt von IList)
IsSynchronized	Ruft einen Wert ab, der angibt, ob der Zugriff auf die ICollection synchronisiert (threadsicher) ist. (Geerbt von ICollection)
Item[Int32]	Ruft das Element am angegebenen Index ab oder legt dieses fest. (Geerbt von IList)
Item[String]	Ruft das IColumnMapping-Objekt mit dem angegebenen SourceColumn-Namen ab oder legt dieses fest.
SyncRoot	Ruft ein Objekt ab, mit dem der Zugriff auf ICollection synchronisiert werden kann. (Geerbt von ICollection)

Methoden

Add(Object)	Fügt der IList ein Element hinzu. (Geerbt von IList)
Add(String, String)	Fügt der ColumnMapping-Auflistung mithilfe des Namens der Quellspalte und des Namens der DataSet-Spalte ein ColumnMapping-Objekt hinzu.
Clear()	Entfernt alle Elemente aus IList. (Geerbt von IList)
Contains(Object)	Ermittelt, ob die IList einen bestimmten Wert enthält. (Geerbt von IList)
Contains(String)	Ruft einen Wert ab, der angibt, ob die DataColumnMappingCollection ein DataColumnMapping-Objekt mit dem angegebenen Quellspaltennamen enthält.
CopyTo(Array, Int32)	Kopiert die Elemente der ICollection in ein Array, beginnend bei einem bestimmten Array-Index. (Geerbt von ICollection)
GetByDataSetColumn(String)	Ruft das ColumnMapping-Objekt mit dem angegebenen DataSet-Spaltennamen ab.
GetEnumerator()	Gibt einen Enumerator zurück, der eine Auflistung durchläuft. (Geerbt von IEnumerable)
IndexOf(Object)	Bestimmt den Index eines bestimmten Elements in der IList. (Geerbt von IList)
IndexOf(String)	Ruft die Position des DataColumnMapping-Objekts mit dem angegebenen Quellspaltennamen ab. Bei dem Namen wird die Groß- und Kleinschreibung berücksichtigt.
Insert(Int32, Object)	Fügt am angegebenen Index ein Element in die IList ein. (Geerbt von IList)
Remove(Object)	Entfernt das erste Vorkommen eines angegebenen Objekts aus der IList. (Geerbt von IList)
RemoveAt(Int32)	Entfernt das IList-Element am angegebenen Index. (Geerbt von IList)
RemoveAt(String)	Entfernt das IColumnMapping-Objekt mit dem angegebenen SourceColumn-Namen aus der Auflistung.

Erweiterungsmethoden

Cast<TResult>(IEnumerable)	Wandelt die Elemente eines IEnumerable in den angegebenen Typ um
OfType<TResult>(IEnumerable)	Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs
AsParallel(IEnumerable)	Ermöglicht die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Konvertiert einen IEnumerable in einen IQueryable.