DataTableMappingCollection.GetTableMappingBySchemaAction Méthode

Définition

Espace de noms:

System.Data.Common

Assembly:

System.Data.Common.dll

Source:

DataTableMappingCollection.cs

Obtient un objet DataColumnMapping portant le nom de table source et le nom de table DataSet spécifiés, à l'aide du MissingMappingAction donné.

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

Paramètres

tableMappings

DataTableMappingCollection

Collection DataTableMappingCollection dans laquelle effectuer la recherche.

sourceTable

String

Nom qui respecte la casse de la table source mappée.

dataSetTable

String

Nom qui ne respecte pas la casse de la table DataSet mappée.

mappingAction

MissingMappingAction

Une des valeurs de l'objet MissingMappingAction.

Retours

DataTableMapping

Objet DataTableMapping.

Exceptions

InvalidOperationException

Le paramètre mappingAction a Error comme valeur et aucun mappage n'est spécifié.

Exemples

L’exemple suivant recherche un DataTableMapping avec le nom de table source donné dans la collection. Si l’objet existe, il est retourné. L’exemple suppose qu’une DataTableMappingCollection collection et un DataTableMapping objet ont été créés.

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

Remarques

Si le DataTableMapping existe dans la collection, il est retourné.

Si le DataTableMapping n’existe pas dans la collection pour un donné MissingMappingAction, les événements suivants se produisent :

MissingMappingAction	Action entreprise
Passthrough	Crée un DataTableMapping objet avec le donné sourceTable comme nom de table source et dataSetTable comme nom de DataSet table. L’objet créé DataTableMapping n’est pas ajouté à la collection.
Error	Une exception est générée. Le paramètre dataSetTable est ignoré.
Ignore	Obtient null. Le paramètre dataSetTable est ignoré.