Condividi tramite


bcp_sendrow

Invia una riga di dati dalle variabili di programma a SQL Server.

Sintassi

RETCODE bcp_sendrow (
    HDBC hdbc);

Argomenti

  • hdbc
    Handle di connessione ODBC abilitato per la copia bulk.

Valori restituiti

SUCCEED o FAIL.

Osservazioni

La funzione bcp_sendrow genera una riga dalle variabili di programma e la invia a SQL Server.

Prima di chiamare bcp_sendrow, è necessario effettuare chiamate a bcp_bind per specificare le variabili di programma che contengono i dati della riga.

Se bcp_bind viene chiamato specificando un tipo di dati Long a lunghezza variabile, ad esempio un parametro eDataType di SQLTEXT e un parametro pData nonNULL, bcp_sendrow invia il valore entiredata come per qualsiasi altro tipo di dati. Se tuttavia per bcp_bind si specifica un parametro pData NULL, bcp_sendrow restituisce immediatamente il controllo all'applicazione dopo avere inviato tutte le colonne con i dati specificati a SQL Server. L'applicazione può quindi chiamare bcp_moretext ripetutamente per inviare i dati Long a lunghezza variabile a SQL Server un blocco alla volta. Per ulteriori informazioni, vedere bcp_moretext.

Quando bcp_sendrow viene utilizzato per eseguire la copia bulk delle righe dalle variabili di programma alle tabelle di SQL Server, il commit delle righe viene eseguito solo se l'utente chiama bcp_batch o bcp_done. L'utente può scegliere di chiamare bcp_batch una volta ogni n righe o quando c'è una pausa nei dati in entrata. Se bcp_batch non viene mai chiamato, il commit delle righe viene eseguito quando viene chiamato bcp_done.

Per informazioni su una modifica di rilievo apportata alla funzione di copia bulk a partire da SQL Server 2005, vedere Esecuzione di operazioni di copia bulk (ODBC).

Vedere anche

Riferimento