OracleLob.CopyTo Metod

Definition

Namnområde:: System.Data.OracleClient

Sammansättning:: System.Data.OracleClient.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Kopierar från detta OracleLob till ett mål OracleLob.

Överlagringar

Name	Description
CopyTo(OracleLob)	Kopierar från detta OracleLob till ett mål OracleLob.
CopyTo(OracleLob, Int64)	Kopierar från detta OracleLob till ett mål OracleLob med den angivna mängden data.
CopyTo(Int64, OracleLob, Int64, Int64)	Kopierar från detta OracleLob till ett mål OracleLob med den angivna mängden data och källförskjutningen.

CopyTo(OracleLob)

Kopierar från detta OracleLob till ett mål OracleLob.

public:
 long CopyTo(System::Data::OracleClient::OracleLob ^ destination);

public long CopyTo(System.Data.OracleClient.OracleLob destination);

member this.CopyTo : System.Data.OracleClient.OracleLob -> int64

override this.CopyTo : System.Data.OracleClient.OracleLob -> int64

Public Function CopyTo (destination As OracleLob) As Long

Parametrar

destination: OracleLob

OracleLobMålet .

Returer

Int64

Antalet kopierade byte. Detta utesluter alla vadderade byte.

Undantag

ArgumentNullException

Den OracleLob som anges i parametern destination är null.

InvalidOperationException

Åtgärden är inte inom en transaktion, objektet OracleLob är null eller så stängs anslutningen.

OracleException

Ett Oracle-fel har inträffat.

Kommentarer

De underliggande datatyperna måste alltid vara desamma. Om du till exempel kopierar från en NClobmåste målet OracleLob också vara en NClob.

Om målförskjutningen ligger utanför målets LOBslut utökas till LOB vilken data kopieras. Utrymmet mellan slutet av LOB och målförskjutningen utanför slutet är vadderat med nollor för BLOB datatyper och blanksteg för CLOB och NCLOB datatyper.

Om du vill skriva till LOBmåste du ha hämtat LOB med hjälp av FOR UPDATE-satsen i SQL SELECT-instruktionen och du måste ha en lokal transaktion igång.

Note

I den här versionen kan en skrivåtgärd till en skrivskyddad LOB fil lyckas, men inte uppdatera LOB på servern. I det här fallet uppdateras dock den lokala kopian av den LOB . Därför kan senare läsåtgärder på OracleLob objektet returnera resultatet av skrivåtgärden.

Metoden CopyTo rensar inte innehållet i målet OracleLob innan kopieringsåtgärden utförs.

Gäller för

CopyTo(OracleLob, Int64)

Kopierar från detta OracleLob till ett mål OracleLob med den angivna mängden data.

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 -> int64

override this.CopyTo : System.Data.OracleClient.OracleLob * int64 -> int64

Public Function CopyTo (destination As OracleLob, destinationOffset As Long) As Long

Parametrar

destination: OracleLob

OracleLobMålet .

destinationOffset: Int64

Förskjutningen som ska kopieras till. För CLOB och NCLOB datatyper måste detta vara ett jämnt antal byte.

Returer

Int64

Antalet kopierade byte. Detta utesluter alla vadderade byte.

Undantag

ArgumentNullException

Angiven OracleLob i parametern destination är full.

ArgumentOutOfRangeException

Ett värde som anges i parametern destinationOffset är mindre än noll eller större än 4 gigabyte.

-eller-

Ett värde som anges i parametern destinationOffset för en datatyp eller CLOB en NCLOB datatyp är inte ens.

-eller-

Du måste ange CLOB och NCLOB datatyper som ett jämnt antal byte.

InvalidOperationException

Åtgärden är inte inom en transaktion, objektet OracleLob är null eller så stängs anslutningen.

OracleException

Ett Oracle-fel har inträffat.

Kommentarer

De underliggande datatyperna måste alltid vara desamma. Om du till exempel kopierar från en NClobmåste målet OracleLob också vara en NClob.

Om du vill skriva till LOBmåste du ha hämtat LOB med hjälp av FOR UPDATE-satsen i SQL SELECT-instruktionen och du måste ha en lokal transaktion igång.

Note

I den här versionen kan en skrivåtgärd till en skrivskyddad LOB fil lyckas, men uppdaterar LOB inte på servern. I det här fallet uppdateras dock den lokala kopian av den LOB . Därför kan senare läsåtgärder på OracleLob objektet returnera resultatet av skrivåtgärden.

Metoden CopyTo rensar inte innehållet i målet OracleLob innan kopieringsåtgärden utförs.

Gäller för

CopyTo(Int64, OracleLob, Int64, Int64)

Kopierar från detta OracleLob till ett mål OracleLob med den angivna mängden data och källförskjutningen.

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 -> int64

override this.CopyTo : int64 * System.Data.OracleClient.OracleLob * int64 * int64 -> int64

Public Function CopyTo (sourceOffset As Long, destination As OracleLob, destinationOffset As Long, amount As Long) As Long

Parametrar

sourceOffset: Int64

Förskjutningen som ska kopieras från. För CLOB och NCLOB datatyper måste detta vara ett jämnt tal.

destination: OracleLob

OracleLob System.Data.OracleClientMålet .

destinationOffset: Int64

Målförskjutningen som ska kopieras till. För CLOB och NCLOB datatyper måste detta vara ett jämnt tal.

amount: Int64

Mängden data i byte som ska kopieras. För CLOB och NCLOB datatyper måste detta vara ett jämnt tal.

Returer

Int64

Antalet kopierade byte. Detta utesluter alla vadderade byte.

Undantag

ArgumentNullException

Angiven OracleLob i parametern destination är full.

ArgumentOutOfRangeException

Ett värde som anges i parametern amount, sourceOffseteller destinationOffset är mindre än noll eller större än 4 gigabyte.

-eller-

Ett värde som anges i parametern amount, sourceOffseteller destinationOffset för en datatyp eller CLOB datatyp NCLOB är inte ens.

InvalidOperationException

Åtgärden är inte inom en transaktion, objektet OracleLob är null eller så stängs anslutningen.

OracleException

Ett Oracle-fel har inträffat.

Kommentarer

De underliggande datatyperna måste alltid vara desamma. Om du till exempel kopierar från en NClobmåste målet OracleLob också vara en NClob.

Om du vill skriva till LOBmåste du ha hämtat LOB med hjälp av FOR UPDATE-satsen i SQL SELECT-instruktionen och du måste ha en lokal transaktion igång.

Note

Metoden CopyTo rensar inte innehållet i målet OracleLob innan kopieringsåtgärden utförs.

Gäller för

Feedback

Var den här sidan till hjälp?