IColumnMapping Interfaccia

Definizione

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, DataColumnMapping, e la aggiunge 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 eredita di implementare una classe Mapping colonne, che associa una colonna origine dati a una DataSet colonna. Per altre informazioni, vedere Mapping DataAdapter DataTable e DataColumn.

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

Le classi che ereditano devono implementare IColumnMapping tutti i membri ereditati e in genere definiscono altri membri per aggiungere funzionalità specifiche del provider. Ad esempio, l'interfaccia IColumnMapping definisce la DataSetColumn proprietà. A sua volta, la classe eredita questa DataColumnMapping 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 e DataSet il nome di colonna di origine 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