OracleLob.Write(Byte[], Int32, Int32) Methode

public:
 override void Write(cli::array <System::Byte> ^ buffer, int offset, int count);

public override void Write(byte[] buffer, int offset, int count);

override this.Write : byte[] * int * int -> unit

Public Overrides Sub Write (buffer As Byte(), offset As Integer, count As Integer)

Parameters

Uitzonderingen

Opmerkingen

Als de schrijfbewerking is geslaagd, wordt de positie binnen de stream vooruit gestegen door het aantal geschreven bytes. Als er een uitzondering optreedt, blijft de positie binnen de stream ongewijzigd.

Schrijven buiten het einde van LOB is toegestaan en vergroot het LOB aantal geschreven bytes.

De .NET Framework-Data Provider voor Oracle verwerkt alle CLOB en NCLOB-gegevens als Unicode. Daarom hebt u bij het openen CLOB en NCLOB gegevenstypen altijd te maken met het aantal bytes, waarbij elk teken 2 bytes is. Als een tekenreeks met drie tekens bijvoorbeeld wordt opgeslagen als een NCLOB Oracle-server waarop de tekenset 4 bytes per teken is en u een Write bewerking uitvoert, geeft u de lengte van de tekenreeks op als 6 bytes, hoewel deze is opgeslagen als 12 bytes op de server.

Als u naar de LOBinstructie WILT schrijven, moet u het LOB gebruik van de FOR UPDATE-component in de SQL SELECT-instructie hebben opgehaald en moet u een lokale transactie hebben gestart.

In het volgende voorbeeld ziet u hoe u naar objecten schrijft OracleLob :

public static void WriteLobExample(OracleCommand command)
{
    // Note: Updating LOB data requires a transaction.
    command.Transaction = command.Connection.BeginTransaction();
    // Select some data.
    //    Table Schema:
    //        "CREATE TABLE tablewithlobs (a int, b BLOB, c BLOB)";
    //        "INSERT INTO tablewithlobs values (1, 'AA', 'AAA')";
    command.CommandText = "SELECT * FROM TableWithLobs FOR UPDATE";
    OracleDataReader reader = command.ExecuteReader();
    using(reader)
    {
        // Obtain the first row of data.
        reader.Read();
        // Obtain both LOBs.
        OracleLob BLOB1 = reader.GetOracleLob(1);
        OracleLob BLOB2 = reader.GetOracleLob(2);
        // Perform any desired operations on the LOB, (read, position, and so on).
        // ...
        // Example - Writing binary data (directly to the backend).
        // To write, you can use any of the stream classes, or write raw binary data using
        // the OracleLob write method. Writing character vs. binary is the same;
        // however note that character is always in terms of Unicode byte counts
        // (for example: even number of bytes - 2 bytes for every Unicode character).
        var buffer = new byte[100];
        buffer[0] = 0xCC;
        buffer[1] = 0xDD;
        BLOB1.Write(buffer, 0, 2);
        BLOB1.Position = 0;
        Console.WriteLine(BLOB1.LobType + ".Write(" + buffer + ", 0, 2) => " + BLOB1.Value);

        // Example - Copying data into another LOB.
        long actual = BLOB1.CopyTo(BLOB2);
        Console.WriteLine(BLOB1.LobType + ".CopyTo(" + BLOB2.Value + ") => " + actual);

        // Commit the transaction now that everything succeeded.
        // Note: On error, Transaction.Dispose is called (from the using statement)
        // and will automatically roll-back the pending transaction.
        command.Transaction.Commit();
    }
}