SqlBulkCopy.DestinationTableName Özellik

Tanım

Ad Alanı:

Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Sunucudaki hedef tablonun adı.

public:
 property System::String ^ DestinationTableName { System::String ^ get(); void set(System::String ^ value); };

public string DestinationTableName { get; set; }

member this.DestinationTableName : string with get, set

Public Property DestinationTableName As String

Özellik Değeri

String

özelliğinin DestinationTableName dize değeri veya sağlanmamışsa null.

Örnekler

Aşağıdaki konsol uygulamasında, zaten açık olan bir bağlantı kullanarak verilerin nasıl toplu olarak yükleneceği gösterilmiştir. Hedef tablo AdventureWorks veritabanındaki bir tablodur.

Bu örnekte, bağlantı ilk olarak bir SQL Server tablosundan örneğe veri okumak için SqlDataReader kullanılır. Kaynak verilerin SQL Server üzerinde bulunması gerekmez; bir öğesine okunabilen veya bir öğesine yüklenebilen herhangi bir IDataReaderDataTableveri kaynağını kullanabilirsiniz.

Önemli

Bu örnek, Toplu Kopyalama Örneği Kurulumu'nda açıklandığı gibi iş tablolarını oluşturmadığınız sürece çalışmaz. Bu kod, yalnızca SqlBulkCopy kullanımına yönelik söz dizimini göstermek için sağlanır. Kaynak ve hedef tablolar aynı SQL Server örneğindeyse, transact-SQL INSERT … SELECT deyimini kullanarak verileri kopyalamak daha kolay ve daha hızlıdır.

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();

            // Open the destination connection. In the real world you would 
            // not use SqlBulkCopy to move data from one table to the other 
            // in the same database. This is for demonstration purposes only.
            using (SqlConnection destinationConnection =
                       new SqlConnection(connectionString))
            {
                destinationConnection.Open();

                // Set up the bulk copy object. 
                // Note that the column positions in the source
                // data reader match the column positions in 
                // the destination table so there is no need to
                // map columns.
                using (SqlBulkCopy bulkCopy =
                           new SqlBulkCopy(destinationConnection))
                {
                    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;";
    }
}

Açıklamalar

çağrıldığında WriteToServer ayarlanmamışsaDestinationTableName, bir ArgumentNullException oluşturulur. İşlem çalışırken değiştirilirse DestinationTableNameWriteToServer , değişiklik geçerli işlemi etkilemez. Yeni DestinationTableName değer, bir WriteToServer sonraki yöntem çağrıldığında kullanılır.

DestinationTableName üç parçalı bir addır (<database>.<owningschema>.<name>). İsterseniz tablo adını veritabanı ve sahip olan şemayla niteleyebilirsiniz. Ancak, tablo adı alt çizgi ("_") veya başka bir özel karakter kullanıyorsa, ([<database>.<owningschema>.<name_01>]) içinde olduğu gibi çevresindeki köşeli ayraçları kullanarak addan kaçış karakteri kullanmanız gerekir.

veya özelliği için gibi bir değer kullanarak verileri geçici bir tabloya toplu olarak tempdb..#tabletempdb.<owner>.#table kopyalayabilirsiniz DestinationTableName .