BinaryIo.new Method

Creates an instance of the .

Syntax

public void new(str filename, str mode)

Run On

Called

Parameters

• filename
  Type: str
  The name of the file to open for this instance of the BinaryIo class.

• mode
  Type: str
  The mode used to create this instance of the BinaryIo class.

Remarks

If an attacker can control input to the new method, a security risk exists. Therefore, this method runs under Code Access Security. Calls to this method on the server require permission from the . Ensure that the user has development privileges by setting the security key to SysDevelopment on the control that calls this method.

Examples

This example uses the BinaryIo class to read data from the ExampleFile text file.

static void BinaryIoExampleW2(Args _args){     #define.ExampleFile(@"D:\Writers\GeneMi\_Junk\TestW.BinaryIo")     #define.ExampleOpenModeW("w")     #define.ExampleOpenModeR("r")         BinaryIo binaryIoObject;     container con1;     str sConRecs;    FileIoPermission perm;       // Set the code access permission to help protect the use of     // the BinaryIo.new method.      perm = new FileIoPermission(#ExampleFile, #ExampleOpenModeW);     if (perm == null)     {         return;     }     perm.assert();         // Overwrites the file if it already exists; restarts it as empty.    binaryIoObject = new BinaryIo(#ExampleFile, #ExampleOpenModeW);         if (binaryIoObject != null)     {         info("w binaryIoObject is NOT null, Good.");        binaryIoObject.write("hello world");        binaryIoObject.write("goodbye solar system");    }     else    {         warning("w binaryIoObject is NULL, Bad.");    }         binaryIoObject.finalize();    binaryIoObject = null; // Close the file, w?            // BinaryIo instance can only read files in that    // are in the exact same esoteric format that BinaryIo    // writes files to.    //    binaryIoObject = new BinaryIo(#ExampleFile, #ExampleOpenModeR);     if (binaryIoObject != null)     {         info("r binaryIoObject is NOT null, Good.");                while (true)        {            con1 = binaryIoObject.read();             if (con1 == conNull())            {                info("r, no more records.");                break;            }            sConRecs = con2Str(con1);            info(sConRecs);        }    }     else    {         warning("r binaryIoObject is NULL, Bad.");    }         binaryIoObject.finalize();    binaryIoObject = null;        WINAPI::deleteFile(#ExampleFile); // Clean up after the job.    CodeAccessPermission::revertAssert(); }/*** Output copied from Infolog:Message (11:22:16 am)w binaryIoObject is NOT null, Good.r binaryIoObject is NOT null, Good.hello worldgoodbye solar systemr, no more records.***/

See Also

Reference

BinaryIo Class