DataTableMappingCollection.GetTableMappingBySchemaAction Método

Definição

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Origem:

DataTableMappingCollection.cs

Obtém um DataColumnMapping objeto com o nome da tabela de origem e o nome da tabela DataSet especificados, usando o MissingMappingAction determinado.

public:
 static System::Data::Common::DataTableMapping ^ GetTableMappingBySchemaAction(System::Data::Common::DataTableMappingCollection ^ tableMappings, System::String ^ sourceTable, System::String ^ dataSetTable, System::Data::MissingMappingAction mappingAction);

public static System.Data.Common.DataTableMapping? GetTableMappingBySchemaAction (System.Data.Common.DataTableMappingCollection? tableMappings, string sourceTable, string dataSetTable, System.Data.MissingMappingAction mappingAction);

static member GetTableMappingBySchemaAction : System.Data.Common.DataTableMappingCollection * string * string * System.Data.MissingMappingAction -> System.Data.Common.DataTableMapping

Public Shared Function GetTableMappingBySchemaAction (tableMappings As DataTableMappingCollection, sourceTable As String, dataSetTable As String, mappingAction As MissingMappingAction) As DataTableMapping

Parâmetros

tableMappings

DataTableMappingCollection

A coleção DataTableMappingCollection a ser pesquisada.

sourceTable

String

O nome que diferencia maiúsculas e minúsculas da tabela de origem mapeada.

dataSetTable

String

O nome, que não diferencia maiúsculas de minúsculas, da tabela DataSet mapeada.

mappingAction

MissingMappingAction

Um dos valores de MissingMappingAction.

Retornos

DataTableMapping

Um objeto DataTableMapping.

Exceções

InvalidOperationException

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

Exemplos

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

public void FindDataTableMapping()
{
    // ...
    // create mappings and mapping
    // ...
    if (mappings.Contains("Categories"))
    {
        mapping = DataTableMappingCollection.GetTableMappingBySchemaAction
            (mappings, "Categories", "", MissingMappingAction.Ignore);
    }
}

Public Sub FindDataTableMapping()
    ' ...
    ' create mappings and mapping
    ' ...
    If mappings.Contains("Categories") Then
        mapping = _
           DataTableMappingCollection.GetTableMappingBySchemaAction _
           (mappings, "Categories", "", MissingMappingAction.Ignore)
    End If
End Sub

Comentários

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

Se o DataTableMapping não existir na coleção para um determinado MissingMappingAction, ocorrerá o seguinte:

Missingmappingaction	Ação executada
Passthrough	Cria um DataTableMapping objeto com o fornecido sourceTable como o nome da tabela de origem e dataSetTable como o nome da DataSet tabela. O objeto criado DataTableMapping não é adicionado à coleção.
Error	Uma exceção é gerada. O parâmetro dataSetTable é ignorado.
Ignore	Obtém null. O parâmetro dataSetTable é ignorado.