SqlBulkCopyOptions Перечисление

Определение

Пространство имен:

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v5.2.0

Побитовый флаг, который определяет один или несколько параметров для использования с экземпляром SqlBulkCopy.

Это перечисление поддерживает побитовую комбинацию значений его членов.

public enum class SqlBulkCopyOptions

[System.Flags]
public enum SqlBulkCopyOptions

[<System.Flags>]
type SqlBulkCopyOptions = 

Public Enum SqlBulkCopyOptions

Наследование

Enum

SqlBulkCopyOptions

Атрибуты

FlagsAttribute

Поля

AllowEncryptedValueModifications	64	Если этот параметр указан, AllowEncryptedValueModifications позволяет выполнять массовое копирование зашифрованных данных между таблицами или базами данных без расшифровки данных. Как правило, приложение выбирает данные из зашифрованных столбцов в одной таблице, не расшифровывая их (для подключения к базе данных используется ключевое слово Column Encryption Setting со значением Disabled), а затем с помощью этого параметра выполняет массовую вставку данных, которые по-прежнему зашифрованы. Будьте внимательны при указании AllowEncryptedValueModifications , так как это может привести к повреждению базы данных, так как драйвер не проверяет, действительно ли данные зашифрованы или правильно ли они зашифрованы с использованием того же типа шифрования, алгоритма и ключа, что и целевой столбец.
CheckConstraints	2	Проверка ограничений при вставке данных. По умолчанию ограничения не проверяются.
Default	0	Для всех параметров используйте значения по умолчанию.
FireTriggers	16	Если этот параметр указан, сервер выполняет триггеры вставки для строк, вставляемых в базу данных.
KeepIdentity	1	Сохранять идентификационные значения источника. Если не указаны, значения идентификаторов назначаются целевым объектом.
KeepNulls	8	Сохранять значения null в целевой таблице независимо от значений параметров по умолчанию. Если не указано, значения NULL заменяются значениями по умолчанию там, где это применимо.
TableLock	4	Применить блокировку массового обновления на время операции массового копирования. Если не указано, используются блокировки строк.
UseInternalTransaction	32	Если этот параметр указан, каждый пакет операции массового копирования будет выполняться в рамках транзакции. Если указать этот параметр, а также предоставить объект SqlTransaction в конструктор, возникнет ArgumentException.

Примеры

В следующем консольном приложении показано, как выполнить массовую загрузку, которая копирует значение из столбца идентификаторов исходной таблицы в соответствующий столбец целевой таблицы, а не создает новое значение для столбца идентификаторов каждой строки.

Чтобы узнать, как параметр изменяет способ работы массовой загрузки, запустите пример с помощью dbo. Таблица BulkCopyDemoMatchingColumns пуста. Все строки загружают из источника. Затем снова запустите пример, не очищая таблицу. Возникает исключение, и код записывает в окно консоли сообщение о том, что строки не были добавлены из-за нарушений первичного ключа.

Важно!

Этот пример не будет выполняться, если вы не создали рабочие таблицы, как описано в разделе Пример установки массового копирования. Этот код предназначен только для демонстрации синтаксиса использования SqlBulkCopy. Если исходная и целевая таблицы находятся в одном экземпляре SQL Server, проще и быстрее использовать инструкцию Transact-SQL INSERT … SELECT для копирования данных.

using System;
using System.Data;
// <Snippet1>
using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        string connectionString = GetConnectionString();
        // Open a sourceConnection to the AdventureWorks database.
        using (SqlConnection sourceConnection =
                   new SqlConnection(connectionString))
        {
            sourceConnection.Open();

            // Perform an initial count on the destination table.
            SqlCommand commandRowCount = new SqlCommand(
                "SELECT COUNT(*) FROM " +
                "dbo.BulkCopyDemoMatchingColumns;",
                sourceConnection);
            long countStart = System.Convert.ToInt32(
                commandRowCount.ExecuteScalar());
            Console.WriteLine("Starting row count = {0}", countStart);

            // Get data from the source table as a SqlDataReader.
            SqlCommand commandSourceData = new SqlCommand(
                "SELECT ProductID, Name, " +
                "ProductNumber " +
                "FROM Production.Product;", sourceConnection);
            SqlDataReader reader =
                commandSourceData.ExecuteReader();

            // Create the SqlBulkCopy object using a connection string 
            // and the KeepIdentity option. 
            // In the real world you would not use SqlBulkCopy to move
            // data from one table to the other in the same database.
            using (SqlBulkCopy bulkCopy =
                new SqlBulkCopy(connectionString, SqlBulkCopyOptions.KeepIdentity))
            {
                bulkCopy.DestinationTableName =
                    "dbo.BulkCopyDemoMatchingColumns";

                try
                {
                    // Write from the source to the destination.
                    bulkCopy.WriteToServer(reader);
                }
                catch (Exception ex)
                {
                    Console.WriteLine(ex.Message);
                }
                finally
                {
                    // Close the SqlDataReader. The SqlBulkCopy
                    // object is automatically closed at the end
                    // of the using block.
                    reader.Close();
                }
            }

            // Perform a final count on the destination 
            // table to see how many rows were added.
            long countEnd = System.Convert.ToInt32(
                commandRowCount.ExecuteScalar());
            Console.WriteLine("Ending row count = {0}", countEnd);
            Console.WriteLine("{0} rows were added.", countEnd - countStart);
            Console.WriteLine("Press Enter to finish.");
            Console.ReadLine();
        }
    }

    private static string GetConnectionString()
    // To avoid storing the sourceConnection string in your code, 
    // you can retrieve it from a configuration file. 
    {
        return "Data Source=(local); " +
            " Integrated Security=true;" +
            "Initial Catalog=AdventureWorks;";
    }
}
// </Snippet1>

Комментарии

Перечисление SqlBulkCopyOptions можно использовать при создании экземпляра SqlBulkCopy , чтобы изменить WriteToServer поведение методов для этого экземпляра.