IColumnMapping Arabirim

Tanım

Bir veri kaynağı sütununu bir sütunla ilişkilendirir DataSet ve DataColumnMapping .NET veri sağlayıcıları tarafından yaygın olarak kullanılan sınıfı tarafından uygulanır.Associates a data source column with a DataSet column, and is implemented by the DataColumnMapping class, which is used in common by .NET data providers.

public interface class IColumnMapping
public interface IColumnMapping
type IColumnMapping = interface
Public Interface IColumnMapping
Türetilmiş

Örnekler

Aşağıdaki örnek, türetilmiş sınıfının bir örneğini oluşturur DataColumnMapping ve bir DataColumnMappingCollection koleksiyona ekler.The following example creates an instance of the derived class, DataColumnMapping, and adds it to a DataColumnMappingCollection collection. Daha sonra kullanıcıya eşlemenin koleksiyona eklendiğini ve eşlemenin üst öğesini gösterdiğini söyler.It then tells the user that the mapping was added to the collection and shows the parent for the 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

Açıklamalar

IColumnMappingArabirim, devralan bir sınıfın bir veri kaynağı sütununu sütunla ilişkilendiren bir sütun eşleme sınıfı uygulamasına olanak sağlar DataSet .The IColumnMapping interface enables an inheriting class to implement a Column Mapping class, which associates a data source column with a DataSet column. Daha fazla bilgi için bkz. DataAdapter DataTable ve DataColumn Mappings.For more information, see DataAdapter DataTable and DataColumn Mappings.

Bir uygulama IColumnMapping doğrudan arabirim örneği oluşturmaz, ancak devralan bir sınıf örneği oluşturur IColumnMapping .An application does not create an instance of the IColumnMapping interface directly, but creates an instance of a class that inherits IColumnMapping.

Devralan sınıflar IColumnMapping tüm devralınan üyeleri uygulamalıdır ve sağlayıcıya özgü işlevselliği eklemek için genellikle ek Üyeler tanımlar.Classes that inherit IColumnMapping must implement all inherited members, and typically define additional members to add provider-specific functionality. Örneğin, IColumnMapping arabirim DataSetColumn özelliği tanımlar.For example, the IColumnMapping interface defines the DataSetColumn property. Sırasıyla, DataColumnMapping sınıfı bu özelliği devralır ve ayrıca GetDataColumnBySchemaAction yöntemini tanımlar.In turn, the DataColumnMapping class inherits this property, and also defines the GetDataColumnBySchemaAction method.

Uygulayanlara Notlar

Arabiriminden devralma sırasında IColumnMapping , aşağıdaki oluşturucuları uygulamalısınız:When you inherit from the IColumnMapping interface, you should implement the following constructors:

ÖğeItem AçıklamaDescription
ColumnMapping ()ColumnMapping() ColumnMapping sınıfının yeni bir örneğini başlatır.Initializes a new instance of the ColumnMapping class.
ColumnMapping (dize sourceColumn, dize dataSetColumn)ColumnMapping(string sourceColumn, string dataSetColumn) Belirtilen kaynak sütun adı ve sütun adına sahip bir kaynak ile ColumnMapping sınıfının yeni bir örneğini başlatır DataSet .Initializes a new instance of the ColumnMapping class with a source with the specified source column name and DataSet column name.

Özellikler

DataSetColumn

Eşlenecek içindeki sütunun adını alır veya ayarlar DataSet .Gets or sets the name of the column within the DataSet to map to.

SourceColumn

Eşlenecek veri kaynağı içindeki sütunun adını alır veya ayarlar.Gets or sets the name of the column within the data source to map from. Bu ad büyük/küçük harfe duyarlıdır.The name is case-sensitive.

Şunlara uygulanır