OracleLob.CopyTo Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| Name | Description |
|---|---|
| CopyTo(OracleLob) | |
| CopyTo(OracleLob, Int64) |
Cópias deste OracleLob para um destino OracleLob com a quantidade de dados especificada. |
| CopyTo(Int64, OracleLob, Int64, Int64) |
Cópias deste OracleLob para um destino OracleLob com a quantidade de dados especificada e o deslocamento de origem. |
CopyTo(OracleLob)
public:
long CopyTo(System::Data::OracleClient::OracleLob ^ destination);public long CopyTo(System.Data.OracleClient.OracleLob destination);member this.CopyTo : System.Data.OracleClient.OracleLob -> int64override this.CopyTo : System.Data.OracleClient.OracleLob -> int64Public Function CopyTo (destination As OracleLob) As LongParâmetros
Devoluções
O número de bytes copiados. Isto exclui quaisquer bytes preenchidos.
Exceções
O OracleLob especificado no destination parâmetro é nulo.
A operação não está dentro de uma transação, o OracleLob objeto é nulo ou a ligação está fechada.
Ocorreu um erro da Oracle.
Observações
Os tipos de dados subjacentes devem ser sempre os mesmos. Por exemplo, se estiver a copiar de um NClob, o destino OracleLob também deve ser um NClob.
Se o deslocamento de destino for além do fim do destino LOB, o LOB para onde os dados estão a ser copiados é estendido. O espaço entre o fim de e LOB o deslocamento de destino para além do fim é preenchido com zeros para BLOB tipos de dados e espaços para CLOB e NCLOB tipos de dados.
Para escrever no LOB, deve ter recuperado usando LOB a cláusula FOR UPDATE na instrução SQL SELECT, e deve ter uma transação local iniciada.
Note
Nesta versão, uma operação de escrita para apenas LOB leitura pode ter sucesso, mas não atualizar o LOB no servidor. Neste caso, no entanto, a cópia local do LOB será atualizada. Portanto, operações de leitura posteriores no OracleLob objeto podem devolver os resultados da operação de escrita.
O CopyTo método não limpa o conteúdo do destino OracleLob antes de realizar a operação de cópia.
Aplica-se a
CopyTo(OracleLob, Int64)
public:
long CopyTo(System::Data::OracleClient::OracleLob ^ destination, long destinationOffset);public long CopyTo(System.Data.OracleClient.OracleLob destination, long destinationOffset);member this.CopyTo : System.Data.OracleClient.OracleLob * int64 -> int64override this.CopyTo : System.Data.OracleClient.OracleLob * int64 -> int64Public Function CopyTo (destination As OracleLob, destinationOffset As Long) As LongParâmetros
- destinationOffset
- Int64
O deslocamento para copiar. Para CLOB os tipos de dados e NCLOB , isto deve ser um número par de bytes.
Devoluções
O número de bytes copiados. Isto exclui quaisquer bytes preenchidos.
Exceções
O OracleLob especificado no destination parâmetro é cheio.
Um valor especificado no destinationOffset parâmetro é inferior a zero ou superior a 4 gigabytes.
-ou-
Um valor especificado no destinationOffset parâmetro para um CLOB tipo de dado ou NCLOB não é par.
-ou-
Deve especificar CLOB os tipos de dados e NCLOB como um número par de bytes.
A operação não está dentro de uma transação, o OracleLob objeto é nulo ou a ligação está fechada.
Ocorreu um erro da Oracle.
Observações
Os tipos de dados subjacentes devem ser sempre os mesmos. Por exemplo, se estiver a copiar de um NClob, o destino OracleLob também deve ser um NClob.
Se o deslocamento de destino for além do fim do destino LOB, o LOB para onde os dados estão a ser copiados é estendido. O espaço entre o final de LOB e o deslocamento de destino para além do fim é preenchido com zeros para BLOB os tipos de dados e espaços para CLOB os tipos de dados e NCLOB .
Para escrever no LOB, deve ter recuperado usando LOB a cláusula FOR UPDATE na instrução SQL SELECT, e deve ter uma transação local iniciada.
Note
Nesta versão, uma operação de escrita para um modo só LOB leitura pode ter sucesso, mas não atualiza o LOB no servidor. Neste caso, no entanto, a cópia local do LOB é atualizada. Portanto, operações de leitura posteriores no OracleLob objeto podem devolver os resultados da operação de escrita.
O CopyTo método não limpa o conteúdo do destino OracleLob antes de realizar a operação de cópia.
Aplica-se a
CopyTo(Int64, OracleLob, Int64, Int64)
public:
long CopyTo(long sourceOffset, System::Data::OracleClient::OracleLob ^ destination, long destinationOffset, long amount);public long CopyTo(long sourceOffset, System.Data.OracleClient.OracleLob destination, long destinationOffset, long amount);member this.CopyTo : int64 * System.Data.OracleClient.OracleLob * int64 * int64 -> int64override this.CopyTo : int64 * System.Data.OracleClient.OracleLob * int64 * int64 -> int64Public Function CopyTo (sourceOffset As Long, destination As OracleLob, destinationOffset As Long, amount As Long) As LongParâmetros
- sourceOffset
- Int64
O deslocamento a partir do qual copiar. Para CLOB os tipos de dados e, NCLOB este deve ser um número par.
- destination
- OracleLob
O destino OracleLobSystem.Data.OracleClient.
- destinationOffset
- Int64
O deslocamento de destino para copiar. Para CLOB os tipos de dados e, NCLOB este deve ser um número par.
- amount
- Int64
A quantidade de dados, em bytes, para copiar. Para CLOB os tipos de dados e, NCLOB este deve ser um número par.
Devoluções
O número de bytes copiados. Isto exclui quaisquer bytes preenchidos.
Exceções
O OracleLob especificado no destination parâmetro é cheio.
Um valor especificado no amount, sourceOffset, ou destinationOffset parâmetro é menor que zero ou superior a 4 gigabytes.
-ou-
Um valor especificado no amount, , ou sourceOffset parâmetro para um destinationOffset tipo de dado ou CLOBNCLOBnão é par.
A operação não está dentro de uma transação, o OracleLob objeto é nulo ou a ligação está fechada.
Ocorreu um erro da Oracle.
Observações
Os tipos de dados subjacentes devem ser sempre os mesmos. Por exemplo, se estiver a copiar de um NClob, o destino OracleLob também deve ser um NClob.
Se o deslocamento de destino for além do fim do destino LOB, o LOB para onde os dados estão a ser copiados é estendido. O espaço entre o final de LOB e o deslocamento de destino para além do fim é preenchido com zeros para BLOB os tipos de dados e espaços para CLOB os tipos de dados e NCLOB .
Para escrever no LOB, deve ter recuperado usando LOB a cláusula FOR UPDATE na instrução SQL SELECT, e deve ter uma transação local iniciada.
Note
Nesta versão, uma operação de escrita para um modo só LOB leitura pode ter sucesso, mas não atualiza o LOB no servidor. Neste caso, no entanto, a cópia local do LOB é atualizada. Portanto, operações de leitura posteriores no OracleLob objeto podem devolver os resultados da operação de escrita.
O CopyTo método não limpa o conteúdo do destino OracleLob antes de realizar a operação de cópia.
