DataAdapter.TableMappings-Eigenschaft

Ruft eine Auflistung ab, die die Masterzuordnung zwischen einer Quelltabelle und einer DataTable bereitstellt.

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

Syntax

'Declaration
Public ReadOnly Property TableMappings As DataTableMappingCollection
'Usage
Dim instance As DataAdapter
Dim value As DataTableMappingCollection

value = instance.TableMappings

public DataTableMappingCollection TableMappings { get; }

public:
property DataTableMappingCollection^ TableMappings {
    DataTableMappingCollection^ get ();
}

/** @property */
public DataTableMappingCollection get_TableMappings ()

public function get TableMappings () : DataTableMappingCollection

Eigenschaftenwert

Eine Auflistung, die die Masterzuordnung zwischen den zurückgegebenen Datensätzen und dem DataSet bereitstellt. Der Standardwert ist eine leere Auflistung.

Hinweise

Beim Abgleichen von Änderungen verwendet der DataAdapter die DataTableMappingCollection-Auflistung, um die von der Datenquelle verwendeten Spaltennamen den vom DataSet verwendeten Spaltennamen zuzuordnen.

Beispiel

Im folgenden Beispiel wird die abgeleitete Klasse OleDbDataAdapter verwendet, um der TableMappings-Auflistung DataTableMapping-Objekte hinzuzufügen und eine Liste der zugeordneten Quelltabellen anzuzeigen. In diesem Beispiel wird davon ausgegangen, dass bereits ein OleDbDataAdapter erstellt wurde.

Public Sub ShowTableMappings()
    ' ...
    ' create myDataAdapter
    ' ...
    myDataAdapter.TableMappings.Add("Categories", "DataCategories")
    myDataAdapter.TableMappings.Add("Orders", "DataOrders")
    myDataAdapter.TableMappings.Add("Products", "DataProducts")
    Dim myMessage As String = "Table Mappings:" + ControlChars.Cr
    Dim i As Integer
    For i = 0 To myDataAdapter.TableMappings.Count - 1
        myMessage += i.ToString() + " " _
           + myDataAdapter.TableMappings(i).ToString() + ControlChars.Cr
    Next i
    MessageBox.Show(myMessage)
End Sub

public void ShowTableMappings() {
   // ...
   // create myDataAdapter
   // ...
   myDataAdapter.TableMappings.Add("Categories","DataCategories");
   myDataAdapter.TableMappings.Add("Orders","DataOrders");
   myDataAdapter.TableMappings.Add("Products","DataProducts");
   string myMessage = "Table Mappings:\n";
   for(int i=0;i < myDataAdapter.TableMappings.Count;i++) {
      myMessage += i.ToString() + " "
         + myDataAdapter.TableMappings[i].ToString() + "\n";
   }
   MessageBox.Show(myMessage);
}

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

DataAdapter-Klasse
DataAdapter-Member
System.Data.Common-Namespace