DataColumnMappingCollection.GetColumnMappingBySchemaAction 方法

给指定的 DataColumnMappingCollection、源列名称和 MissingMappingAction 获取一个 DataColumnMapping

**命名空间:**System.Data.Common
**程序集:**System.Data(在 system.data.dll 中)

语法

声明
Public Shared Function GetColumnMappingBySchemaAction ( _
    columnMappings As DataColumnMappingCollection, _
    sourceColumn As String, _
    mappingAction As MissingMappingAction _
) As DataColumnMapping
用法
Dim columnMappings As DataColumnMappingCollection
Dim sourceColumn As String
Dim mappingAction As MissingMappingAction
Dim returnValue As DataColumnMapping

returnValue = DataColumnMappingCollection.GetColumnMappingBySchemaAction(columnMappings, sourceColumn, mappingAction)
public static DataColumnMapping GetColumnMappingBySchemaAction (
    DataColumnMappingCollection columnMappings,
    string sourceColumn,
    MissingMappingAction mappingAction
)
public:
static DataColumnMapping^ GetColumnMappingBySchemaAction (
    DataColumnMappingCollection^ columnMappings, 
    String^ sourceColumn, 
    MissingMappingAction mappingAction
)
public static DataColumnMapping GetColumnMappingBySchemaAction (
    DataColumnMappingCollection columnMappings, 
    String sourceColumn, 
    MissingMappingAction mappingAction
)
public static function GetColumnMappingBySchemaAction (
    columnMappings : DataColumnMappingCollection, 
    sourceColumn : String, 
    mappingAction : MissingMappingAction
) : DataColumnMapping

参数

  • sourceColumn
    要查找的区分大小写的源列名称。

返回值

一个 DataColumnMapping 对象。

异常

异常类型 条件

InvalidOperationException

mappingAction 参数设置为 Error,并且未指定任何映射。

备注

如果集合中存在 DataColumnMapping,则将其返回。

对于给定的 MissingMappingAction,如果集合中不存在 DataColumnMapping,则发生以下操作:

MissingMappingAction

采取的操作

Passthrough

创建一个 DataColumnMapping,它所具有的指定的源列名称为,既有源列名称又有 DataSet 列名。此 DataColumnMapping 不添加到集合中。

Error

如果缺少指定的列映射,则生成 InvalidOperationException

Ignore

获取一个空值。

示例

下面的示例在集合中搜索具有给定源列名称的 DataColumnMapping。如果该对象存在,则将其返回。此示例假定已经创建了 DataColumnMappingCollection 集合和 DataColumnMapping 对象。

Public Sub FindDataColumnMapping()
    ' ...
    ' create mappings and mapping
    ' ...
    If mappings.Contains("Description") Then
        mapping = _
           DataColumnMappingCollection.GetColumnMappingBySchemaAction _
           (mappings, "Description", MissingMappingAction.Ignore)
    End If
End Sub
public void FindDataColumnMapping() 
{
    // ...
    // create mappings and mapping
    // ...
    if (mappings.Contains("Description"))
        mapping = DataColumnMappingCollection.GetColumnMappingBySchemaAction
            (mappings, "Description", MissingMappingAction.Ignore);
}

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表,请参见系统要求

版本信息

.NET Framework

受以下版本支持:2.0、1.1、1.0

.NET Compact Framework

受以下版本支持:2.0、1.0

请参见

参考

DataColumnMappingCollection 类
DataColumnMappingCollection 成员
System.Data.Common 命名空间