IColumnMapping Interfaccia

  • Riferimento

Definizione

Spazio dei nomi:
System.Data
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Consente di associare una colonna di un'origine dati a una colonna di un oggetto DataSet e viene implementata dalla classe DataColumnMapping, usata in comune dai provider di dati .NET.

public interface class IColumnMapping
public interface IColumnMapping
type IColumnMapping = interface
Public Interface IColumnMapping
Derivato

Esempio

Nell'esempio seguente viene creata un'istanza della classe derivata , DataColumnMappinge viene aggiunta a una DataColumnMappingCollection raccolta. Indica quindi all'utente che il mapping è stato aggiunto alla raccolta e mostra l'elemento padre per il mapping.


public void AddDataColumnMapping() {
   // ...
   // create columnMappings
   // ...
   DataColumnMapping mapping =
      new DataColumnMapping("Description","DataDescription");
   columnMappings.Add((Object) mapping);
   Console.WriteLine("Column {0} added to column mapping collection {1}.",
       mapping.ToString(), columnMappings.ToString());
}

Public Sub AddDataColumnMapping()
    ' ...
    ' create columnMappings
    ' ...
    Dim mapping As New DataColumnMapping( _
       "Description", "DataDescription")
    columnMappings.Add(CType(mapping, Object))
    Console.WriteLine("Column {0} added to column mapping collection {1}.", _
       mapping.ToString(), columnMappings.ToString())
End Sub

Commenti

L'interfaccia IColumnMapping consente a una classe che eredita di implementare una classe Mapping colonne, che associa una colonna dell'origine dati a una DataSet colonna. Per altre informazioni, vedere DataAdapter DataTable e Mapping DataColumn.

Un'applicazione non crea direttamente un'istanza dell'interfaccia IColumnMapping , ma crea un'istanza di una classe che eredita IColumnMapping.

Le classi che ereditano IColumnMapping devono implementare tutti i membri ereditati e in genere definiscono membri aggiuntivi per aggiungere funzionalità specifiche del provider. Ad esempio, l'interfaccia IColumnMapping definisce la DataSetColumn proprietà . A sua volta, la DataColumnMapping classe eredita questa proprietà e definisce anche il GetDataColumnBySchemaAction metodo .

Note per gli implementatori

Quando si eredita dall'interfaccia IColumnMapping , è necessario implementare i costruttori seguenti:

Elemento Descrizione
ColumnMapping() Inizializza una nuova istanza della classe ColumnMapping.
ColumnMapping(string sourceColumn, string dataSetColumn) Inizializza una nuova istanza della classe ColumnMapping con un'origine con il nome della colonna di origine e DataSet il nome della colonna specificati.

Proprietà

DataSetColumn

Ottiene o imposta il nome della colonna all'interno dell'oggetto DataSet in base al quale effettuare il mapping.
SourceColumn

Ottiene o imposta il nome della colonna all'interno dell'origine dati da cui eseguire il mapping. Per il nome è prevista la distinzione tra maiuscole e minuscole.

Si applica a