DataColumnMappingCollection.GetColumnMappingBySchemaAction Método

Referência

Definição

Namespace:: System.Data.Common

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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);

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 procura 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 existir DataColumnMapping na coleção, ela será retornada.

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

Missingmappingaction	Ação tomada
`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.

Aplica-se a

Confira também

Visão geral do ADO.NET