كيفية القيام بما يلي: استخدام دالة ReadFile Windows (ارشادات برمجة C#)
يوضح هذا المثال دالة Windows ReadFile عن طريق قراءة وعرض ملف نصي. تتطلب الدالة ReadFile استخدام التعليمات البرمجية unsafe لأنه يتطلب مؤشر كمعلمة.
يمرر صفيف البايت خلال الدالة Read هو نوع مدارة. وهذا يعني أنه وقت تشغيل اللغة العامة (CLR) فإن حاوي المهملات قد ينقل الذاكرة المستخدمة من قبل الصفيف في إعادة تحديد الموضع. لمنع هذا ثابت يُستخدم للحصول على مؤشر للذاكرة ووضع علامة عليه بحيث لن يحركها حاوي المهملات. في نهاية الكتلة fixed، ترجع الذاكرة تلقائياً تعود لتصبح كائناً يتحرك خلال مجموعة البيانات المهملة.
تُعرف هذه الإمكانية بـ التحديد المعرّف. مع الإضافة، يوجد مقدار حِمل قليل جداً إلا إذا كان مجموعة البيانات المهملة تحدث في كتلة fixed بحيث لا يحبذ حدوثها. ومع ذلك،قد يؤدي التدبيس إلى بعض الآثار الجانبية الغير مرغوب فيها أثناء تشغيل تجميع البيانات المهملة العمومي. القدرة على تجميع البيانات المهملة لضغط الذاكرة المحدودة يحد بشكل كبير من المخازن المضافة. ولذلك، يجب تجنب الإضافة كلما كان ممكناً.
مثال
class FileReader
{
const uint GENERIC_READ = 0x80000000;
const uint OPEN_EXISTING = 3;
System.IntPtr handle;
[System.Runtime.InteropServices.DllImport("kernel32", SetLastError = true, ThrowOnUnmappableChar = true, CharSet = System.Runtime.InteropServices.CharSet.Unicode)]
static extern unsafe System.IntPtr CreateFile
(
string FileName, // file name
uint DesiredAccess, // access mode
uint ShareMode, // share mode
uint SecurityAttributes, // Security Attributes
uint CreationDisposition, // how to create
uint FlagsAndAttributes, // file attributes
int hTemplateFile // handle to template file
);
[System.Runtime.InteropServices.DllImport("kernel32", SetLastError = true)]
static extern unsafe bool ReadFile
(
System.IntPtr hFile, // handle to file
void* pBuffer, // data buffer
int NumberOfBytesToRead, // number of bytes to read
int* pNumberOfBytesRead, // number of bytes read
int Overlapped // overlapped buffer
);
[System.Runtime.InteropServices.DllImport("kernel32", SetLastError = true)]
static extern unsafe bool CloseHandle
(
System.IntPtr hObject // handle to object
);
public bool Open(string FileName)
{
// open the existing file for reading
handle = CreateFile
(
FileName,
GENERIC_READ,
0,
0,
OPEN_EXISTING,
0,
0
);
if (handle != System.IntPtr.Zero)
{
return true;
}
else
{
return false;
}
}
public unsafe int Read(byte[] buffer, int index, int count)
{
int n = 0;
fixed (byte* p = buffer)
{
if (!ReadFile(handle, p + index, count, &n, 0))
{
return 0;
}
}
return n;
}
public bool Close()
{
return CloseHandle(handle);
}
}
class Test
{
static int Main(string[] args)
{
if (args.Length != 1)
{
System.Console.WriteLine("Usage : ReadFile <FileName>");
return 1;
}
if (!System.IO.File.Exists(args[0]))
{
System.Console.WriteLine("File " + args[0] + " not found.");
return 1;
}
byte[] buffer = new byte[128];
FileReader fr = new FileReader();
if (fr.Open(args[0]))
{
// Assume that an ASCII file is being read.
System.Text.ASCIIEncoding Encoding = new System.Text.ASCIIEncoding();
int bytesRead;
do
{
bytesRead = fr.Read(buffer, 0, buffer.Length);
string content = Encoding.GetString(buffer, 0, bytesRead);
System.Console.Write("{0}", content);
}
while (bytesRead > 0);
fr.Close();
return 0;
}
else
{
System.Console.WriteLine("Failed to open requested file");
return 1;
}
}
}
راجع أيضًا:
المرجع
التعليمات البرمجية الغير آمنة والمؤشرات (دليل البرمجة لـ #C)