SqlBulkCopy.DestinationTableName Vlastnost

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

Název cílové tabulky na serveru

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

Hodnota vlastnosti

String

Řetězcová hodnota DestinationTableName vlastnosti nebo null, pokud nebyla zadána žádná.

Příklady

Následující konzolová aplikace ukazuje, jak hromadně načíst data pomocí již otevřeného připojení. Cílová tabulka je tabulka v databázi AdventureWorks .

V tomto příkladu se připojení nejprve použije ke čtení dat z tabulky SQL Server do SqlDataReader instance. Zdrojová data nemusí být umístěna na SQL Server. Můžete použít libovolný zdroj dat, který lze načíst do objektu IDataReader nebo načíst do DataTable.

Důležité

Tato ukázka se nespustí, pokud jste nevytvořili pracovní tabulky, jak je popsáno v části Ukázková instalace hromadného kopírování. Tento kód slouží k předvedení syntaxe pouze pro použití SqlBulkCopy . Pokud jsou zdrojová a cílová tabulka ve stejné SQL Server instanci, je jednodušší a rychlejší použít příkaz jazyka Transact-SQL INSERT … SELECT ke kopírování dat.

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;";
    }
}

Poznámky

Pokud DestinationTableName nebyla nastavena, když WriteToServer je volána, ArgumentNullException je vyvolána. Pokud DestinationTableName se změní v době, kdy WriteToServer je operace spuštěná, tato změna neovlivní aktuální operaci. Nová DestinationTableName hodnota se použije při příštím zavolání WriteToServer metody.

DestinationTableName je název se třemi částmi (<database>.<owningschema>.<name>). Pokud se rozhodnete, můžete název tabulky kvalifikovat pomocí databáze a vlastnícího schématu. Pokud ale název tabulky používá podtržítko ("_") nebo jakékoli jiné speciální znaky, musíte název utéct pomocí okolních závorek jako v ([<database>.<owningschema>.<name_01>]).

Data můžete hromadně zkopírovat do dočasné tabulky pomocí hodnoty, jako tempdb..#tabletempdb.<owner>.#table je nebo pro DestinationTableName vlastnost.