DataTableMappingCollection.GetTableMappingBySchemaAction Método

Definição

Namespace:
System.Data.Common
Assembly:
System.Data.dll
Assembly:
netstandard.dll

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

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 DataTableMappingCollection coleção a ser pesquisada.

sourceTable
String

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

dataSetTable
String

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

mappingAction
MissingMappingAction

Um dos MissingMappingAction valores.

Retornos

DataTableMapping

Um DataTableMapping objeto.

Exceções

InvalidOperationException

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

Exemplos

O exemplo a seguir procura 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 existir DataTableMapping na coleção, ela será retornada.

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

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

Aplica-se a