DataColumnMappingCollection.GetColumnMappingBySchemaAction Método

Definição

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Origem:

DataColumnMappingCollection.cs

Obtém um DataColumnMapping especificado DataColumnMappingCollection, nome da coluna de origem e 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);

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

Parâmetros

columnMappings

DataColumnMappingCollection

O DataColumnMappingCollection.

sourceColumn

String

O nome da coluna de origem que diferencia maiúsculas de minúsculas a ser localizado.

mappingAction

MissingMappingAction

Um dos valores de MissingMappingAction.

Retornos

DataColumnMapping

Um objeto DataColumnMapping.

Exceções

InvalidOperationException

O parâmetro mappingAction foi definido como Error e nenhum mapeamento foi especificado.

Exemplos

O exemplo a seguir pesquisa um DataColumnMapping com o nome de coluna de origem fornecido dentro da coleção. Se o objeto existir, ele será retornado. O exemplo pressupõe que uma DataColumnMappingCollection coleção e um DataColumnMapping objeto foram criados.

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

Comentários

Se o DataColumnMapping existir na coleção, ele será retornado.

Se o DataColumnMapping não existir na coleção, para um determinado MissingMappingAction, ocorrerão as seguintes ações:

Missingmappingaction	Ação executada
Passthrough	Cria um DataColumnMapping com o nome da coluna de origem especificado como o nome da coluna de origem e o nome da DataSet coluna. Isso DataColumnMapping não é adicionado à coleção.
Error	Um InvalidOperationException será gerado se o mapeamento de coluna especificado estiver ausente.
Ignore	Obtém um valor nulo.

Confira também

• Visão geral do ADO.NET