DataColumnMappingCollection.GetColumnMappingBySchemaAction Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает объект DataColumnMapping для указанного DataColumnMappingCollection, имени исходного столбца и MissingMappingAction.
public:
static System::Data::Common::DataColumnMapping ^ GetColumnMappingBySchemaAction(System::Data::Common::DataColumnMappingCollection ^ columnMappings, System::String ^ sourceColumn, System::Data::MissingMappingAction mappingAction);
public static System.Data.Common.DataColumnMapping? GetColumnMappingBySchemaAction (System.Data.Common.DataColumnMappingCollection? columnMappings, string sourceColumn, System.Data.MissingMappingAction mappingAction);
public static System.Data.Common.DataColumnMapping GetColumnMappingBySchemaAction (System.Data.Common.DataColumnMappingCollection columnMappings, string sourceColumn, System.Data.MissingMappingAction mappingAction);
static member GetColumnMappingBySchemaAction : System.Data.Common.DataColumnMappingCollection * string * System.Data.MissingMappingAction -> System.Data.Common.DataColumnMapping
Public Shared Function GetColumnMappingBySchemaAction (columnMappings As DataColumnMappingCollection, sourceColumn As String, mappingAction As MissingMappingAction) As DataColumnMapping
Параметры
- columnMappings
- DataColumnMappingCollection
- sourceColumn
- String
Зависящее от регистра имя исходного столбца для поиска.
- mappingAction
- MissingMappingAction
Одно из значений перечисления MissingMappingAction.
Возвращаемое значение
Объект DataColumnMapping.
Исключения
Для параметра mappingAction
было задано значение Error
и не было указано сопоставление.
Примеры
В следующем примере выполняется DataColumnMapping поиск с заданным именем исходного столбца в коллекции. Если объект существует, он возвращается. В примере предполагается DataColumnMappingCollection , что коллекция и DataColumnMapping объект были созданы.
public void FindDataColumnMapping()
{
// ...
// create mappings and mapping
// ...
if (mappings.Contains("Description"))
mapping = DataColumnMappingCollection.GetColumnMappingBySchemaAction
(mappings, "Description", MissingMappingAction.Ignore);
}
Public Sub FindDataColumnMapping()
' ...
' create mappings and mapping
' ...
If mappings.Contains("Description") Then
mapping = _
DataColumnMappingCollection.GetColumnMappingBySchemaAction _
(mappings, "Description", MissingMappingAction.Ignore)
End If
End Sub
Комментарии
Если объект DataColumnMapping существует в коллекции, он возвращается.
DataColumnMapping Если объект не существует в коллекции, для заданного MissingMappingAction, выполняются следующие действия:
MissingMappingAction | Предпринятое действие |
---|---|
Passthrough |
DataColumnMapping Создает объект с указанным именем исходного столбца в качестве имени исходного столбца и имени столбцаDataSet. Он DataColumnMapping не добавляется в коллекцию. |
Error |
Если отсутствует сопоставление указанного столбца, создается исключение InvalidOperationException. |
Ignore |
Возвращает значение NULL. |