Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase SqlBulkCopyColumnMappingCollection

 

Publicado: octubre de 2016

Colección de objetos SqlBulkCopyColumnMapping que hereda de CollectionBase.

Espacio de nombres:   System.Data.SqlClient
Ensamblado:  System.Data (en System.Data.dll)

System.Object
  System.Collections.CollectionBase
    System.Data.SqlClient.SqlBulkCopyColumnMappingCollection

public sealed class SqlBulkCopyColumnMappingCollection : CollectionBase

NombreDescripción
System_CAPS_pubpropertyCapacity

Obtiene o establece el número de elementos que puede contener CollectionBase.(Heredado de CollectionBase).

System_CAPS_pubpropertyCount

Obtiene el número de elementos incluidos en la instancia de CollectionBase. Esta propiedad no se puede invalidar.(Heredado de CollectionBase).

System_CAPS_pubpropertyItem[Int32]

Obtiene la SqlBulkCopyColumnMapping objeto en el índice especificado.

NombreDescripción
System_CAPS_pubmethodAdd(Int32, Int32)

Crea un nuevo SqlBulkCopyColumnMapping y lo agrega a la colección, utilizando las posiciones ordinales para especificar las columnas de origen y de destino.

System_CAPS_pubmethodAdd(Int32, String)

Crea un nuevo SqlBulkCopyColumnMapping y lo agrega a la colección con un ordinal de la columna de origen y una cadena para la columna de destino.

System_CAPS_pubmethodAdd(SqlBulkCopyColumnMapping)

Agrega la asignación especificada en el SqlBulkCopyColumnMappingCollection.

System_CAPS_pubmethodAdd(String, Int32)

Crea un nuevo SqlBulkCopyColumnMapping y lo agrega a la colección con un nombre de columna para describir la columna de origen y un valor ordinal para especificar la columna de destino.

System_CAPS_pubmethodAdd(String, String)

Crea un nuevo SqlBulkCopyColumnMapping y lo agrega a la colección, utilizando nombres de columna para especificar las columnas de origen y de destino.

System_CAPS_pubmethodClear()

Borra el contenido de la colección.

System_CAPS_pubmethodContains(SqlBulkCopyColumnMapping)

Obtiene un valor que indica si un objeto SqlBulkCopyColumnMapping objeto existe en la colección.

System_CAPS_pubmethodCopyTo(SqlBulkCopyColumnMapping[], Int32)

Copia los elementos de la SqlBulkCopyColumnMappingCollection a una matriz de SqlBulkCopyColumnMapping elementos, empezando por un índice determinado.

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_pubmethodGetEnumerator()

Devuelve un enumerador que recorre en iteración la CollectionBase instancia.(Heredado de CollectionBase).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodIndexOf(SqlBulkCopyColumnMapping)

Obtiene el índice del elemento SqlBulkCopyColumnMapping objeto.

System_CAPS_pubmethodInsert(Int32, SqlBulkCopyColumnMapping)

Inserte un nuevo SqlBulkCopyColumnMapping en el índice especificado.

System_CAPS_pubmethodRemove(SqlBulkCopyColumnMapping)

Quita SqlBulkCopyColumnMapping elemento desde el SqlBulkCopyColumnMappingCollection.

System_CAPS_pubmethodRemoveAt(Int32)

Quita la asignación en el índice especificado de la colección.

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethodICollection.CopyTo(Array, Int32)

Copia la totalidad de CollectionBase en una matriz Array unidimensional compatible, comenzando en el índice especificado de la matriz de destino.(Heredado de CollectionBase).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Add(Object)

Agrega un objeto al final de CollectionBase.(Heredado de CollectionBase).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Contains(Object)

Determina si CollectionBase contiene un elemento específico.(Heredado de CollectionBase).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.IndexOf(Object)

Busca el objeto Object especificado y devuelve el índice de base cero de la primera aparición en toda la colección CollectionBase.(Heredado de CollectionBase).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Insert(Int32, Object)

Inserta un elemento en CollectionBase, en el índice especificado.(Heredado de CollectionBase).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Remove(Object)

Quita la primera aparición de un objeto específico de la interfaz CollectionBase.(Heredado de CollectionBase).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.IsSynchronized

Obtiene un valor que indica si el acceso a la interfaz CollectionBase está sincronizado (es seguro para subprocesos).(Heredado de CollectionBase).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.SyncRoot

Obtiene un objeto que se puede usar para sincronizar el acceso a CollectionBase.(Heredado de CollectionBase).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.IsFixedSize

Obtiene un valor que indica si la interfaz CollectionBase tiene un tamaño fijo.(Heredado de CollectionBase).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.IsReadOnly

Obtiene un valor que indica si CollectionBase es de solo lectura.(Heredado de CollectionBase).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.Item[Int32]

Obtiene o establece el elemento en el índice especificado.(Heredado de CollectionBase).

NombreDescripción
System_CAPS_pubmethodAsParallel()

Sobrecargado. Habilita la paralelización de una consulta.(Definido por ParallelEnumerable).

System_CAPS_pubmethodAsQueryable()

Sobrecargado. Convierte un IEnumerable para un IQueryable.(Definido por Queryable).

System_CAPS_pubmethodCast<TResult>()

Convierte los elementos de un IEnumerable al tipo especificado.(Definido por Enumerable).

System_CAPS_pubmethodOfType<TResult>()

Filtra los elementos de un IEnumerable basado en un tipo especificado.(Definido por Enumerable).

Asignaciones de columnas definen la asignación entre el origen de datos y la tabla de destino.

Si no hay asignaciones definidas, es decir, el ColumnMappings colección está vacía, se asignan las columnas implícitamente basándose en la posición ordinal. Para que funcione, los esquemas de origen y de destino deben coincidir. Si no lo hacen, un InvalidOperationException se produce.

Si el ColumnMappings colección no está vacía, no todas las columnas presentes en el origen de datos tienen que especificarse. Se omiten las no asignadas por la colección.

Puede hacer referencia a columnas de origen y de destino por nombre u ordinal. Se pueden mezclar las y referencias de columna por ordinal en la misma colección de asignaciones.

La siguiente ejemplo copia datos masivamente desde una tabla de origen en el AdventureWorks base de datos de ejemplo a una tabla de destino en la misma base de datos. Aunque el número de columnas de destino coincide con el número de columnas en el origen, los nombres de columna y posiciones ordinales no coinciden. SqlBulkCopyColumnMapping se agregan a la SqlBulkCopyColumnMappingCollection para el SqlBulkCopy objeto para crear un mapa de columnas para la copia masiva.

System_CAPS_importantImportante

Este ejemplo no se ejecutará a menos que haya creado las tablas de trabajo como se describe en Configuración de ejemplo de copia masiva. Este código se proporciona para mostrar cuál debe ser la sintaxis cuando solo se utiliza SqlBulkCopy. Si las tablas de origen y destino están en la misma instancia de SQL Server, es más fácil y rápido usar Transact-SQL INSERT … SELECT instrucción para copiar los datos.

using System.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.BulkCopyDemoDifferentColumns;",
                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();

            // Set up the bulk copy object. 
            using (SqlBulkCopy bulkCopy =
                       new SqlBulkCopy(connectionString))
            {
                bulkCopy.DestinationTableName =
                    "dbo.BulkCopyDemoDifferentColumns";

                // The column order in the source doesn't match the order 
                // in the destination, so ColumnMappings must be defined.
                bulkCopy.ColumnMappings.Add("ProductID", "ProdID");
                bulkCopy.ColumnMappings.Add("Name", "ProdName");
                bulkCopy.ColumnMappings.Add("ProductNumber", "ProdNum");

                // Write from the source to the destination.
                try
                {
                    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;";
    }
}

.NET Framework
Disponible desde 2.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: