DataTableMappingCollection.GetTableMappingBySchemaAction(DataTableMappingCollection, String, String, MissingMappingAction) Метод

Определение

Получает объект DataColumnMapping с указанным именем исходной таблицы и именем таблицы DataSet с помощью заданного MissingMappingAction.Gets a DataColumnMapping object with the specified source table name and DataSet table name, using the given 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

Параметры

tableMappings
DataTableMappingCollection

Коллекция DataTableMappingCollection для поиска.The DataTableMappingCollection collection to search.

sourceTable
String

Имя сопоставленной исходной таблицы, определяемое с учетом регистра.The case-sensitive name of the mapped source table.

dataSetTable
String

Имя сопоставленной таблицы DataSet без учета регистра.The name, which is not case-sensitive, of the mapped DataSet table.

mappingAction
MissingMappingAction

Одно из значений MissingMappingAction.One of the MissingMappingAction values.

Возвраты

Исключения

Для параметра mappingAction было задано значение Error и не было указано сопоставление.The mappingAction parameter was set to Error, and no mapping was specified.

Примеры

В следующем примере выполняется поиск объекта DataTableMapping с заданным именем исходной таблицы в коллекции.The following example searches for a DataTableMapping with the given source table name within the collection. Если объект существует, он возвращается.If the object exists, it is returned. В примере предполагается, DataTableMappingCollection что была создана DataTableMapping коллекция и объект.The example assumes that a DataTableMappingCollection collection and a DataTableMapping object have been created.

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

Комментарии

Если объект DataTableMapping существует в коллекции, он возвращается.If the DataTableMapping exists in the collection, it is returned.

Если объект DataTableMapping не существует в коллекции для заданного MissingMappingActionтипа, происходит следующее:If the DataTableMapping does not exist in the collection for a given MissingMappingAction, the following happens:

миссингмаппингактионMissingMappingAction Предпринятое действиеAction taken
Passthrough Создает объект с заданным sourceTable как именем исходной DataSet таблицы и dataSetTable именем таблицы. DataTableMappingCreates a DataTableMapping object with the given sourceTable as the source table name and dataSetTable as the DataSet table name. Созданный DataTableMapping объект не добавляется в коллекцию.The created DataTableMapping object is not added to the collection.
Error Создается исключение.An exception is generated. dataSetTable Параметр игнорируется.The dataSetTable parameter is ignored.
Ignore Получает null.Gets null. dataSetTable Параметр игнорируется.The dataSetTable parameter is ignored.

Применяется к