DataColumnMappingCollection.GetColumnMappingBySchemaAction Método

  • Referência

Definição

Namespace:
System.Data.Common
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll
Origem:
DataColumnMappingCollection.cs
Origem:
DataColumnMappingCollection.cs
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);
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.

Aplica-se a

Confira também