MemoryMappedFile.CreateNew Yöntem

Tanım

Ad Alanı:

System.IO.MemoryMappedFiles

Bütünleştirilmiş Kod:

System.IO.MemoryMappedFiles.dll

Sistem belleğinde belleğe eşlenmiş bir dosya oluşturur.

Aşırı Yüklemeler

CreateNew(String, Int64)	Sistem belleğinde belirtilen kapasiteye sahip, belleğe eşlenmiş bir dosya oluşturur.
CreateNew(String, Int64, MemoryMappedFileAccess)	Sistem belleğinde belirtilen kapasiteye ve erişim türüne sahip, belleğe eşlenmiş bir dosya oluşturur.
CreateNew(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability)	Belirtilen ada, kapasiteye, erişim türüne, bellek ayırma seçeneklerine ve devralınabilirliğe sahip, belleğe eşlenmiş bir dosya oluşturur.

CreateNew(String, Int64)

Kaynak:

MemoryMappedFile.cs

Sistem belleğinde belirtilen kapasiteye sahip, belleğe eşlenmiş bir dosya oluşturur.

public static System.IO.MemoryMappedFiles.MemoryMappedFile CreateNew (string? mapName, long capacity);

Parametreler

mapName

String

Bellekle eşlenen dosyaya atanacak veya null işlemler arasında paylaşmayı amaçlamadığınız bir MemoryMappedFile ad.

capacity

Int64

Bellekle eşlenen dosyaya ayrılacak en büyük boyut (bayt cinsinden).

Döndürülenler

MemoryMappedFile

Belirtilen ada ve kapasiteye sahip, belleğe eşlenmiş bir dosya.

Özel durumlar

ArgumentException

mapName boş bir dizedir.

ArgumentOutOfRangeException

capacity sıfırdan küçük veya sıfıra eşit.

PlatformNotSupportedException

Yalnızca .NET Core ve .NET 5+ : Adlandırılmış bellek eşlenmiş dosyasıyla (null mapNameolmayan bir dosya) yöntemine yapılan çağrılar CreateNew yalnızca Windows işletim sistemlerinde desteklenir.

Örnekler

Aşağıdaki örnek, bellekle eşlenen bir dosyaya değer yazan Boolean üç ayrı işlemden (konsol uygulamaları) oluşur. Aşağıdaki eylem dizisi gerçekleşir:

1. İşlem A, belleğe eşlenmiş dosyayı oluşturur ve buna bir değer yazar.

2. B işlemi bellekle eşlenen dosyayı açar ve buna bir değer yazar.

3. C işlemi, belleğe eşlenen dosyayı açar ve buna bir değer yazar.

4. İşlem A, bellekle eşlenen dosyadaki değerleri okur ve görüntüler.

5. A İşlemi bellek eşlemeli dosyayla tamamlandıktan sonra, dosya çöp toplama tarafından hemen geri kazanılır.

Bu örneği çalıştırmak için aşağıdakileri yapın:

1. Uygulamaları derleyin ve üç Komut penceresi açın.

2. İlk Komut penceresinde İşlem A'yı çalıştırın.

3. İkinci Komut penceresinde B İşlemi'ni çalıştırın.

4. İşlem A'ya dönün ve ENTER tuşuna basın.

5. Üçüncü Komut penceresinde İşlem C'yi çalıştırın.

6. İşlem A'ya dönün ve ENTER tuşuna basın.

İşlem A'nın çıkışı aşağıdaki gibidir:

Start Process B and press ENTER to continue.
Start Process C and press ENTER to continue.
Process A says: True
Process B says: False
Process C says: True

İşlem A

using System;
using System.IO;
using System.IO.MemoryMappedFiles;
using System.Threading;

class Program
{
    // Process A:
    static void Main(string[] args)
    {
        using (MemoryMappedFile mmf = MemoryMappedFile.CreateNew("testmap", 10000))
        {
            bool mutexCreated;
            Mutex mutex = new Mutex(true, "testmapmutex", out mutexCreated);
            using (MemoryMappedViewStream stream = mmf.CreateViewStream())
            {
                BinaryWriter writer = new BinaryWriter(stream);
                writer.Write(1);
            }
            mutex.ReleaseMutex();

            Console.WriteLine("Start Process B and press ENTER to continue.");
            Console.ReadLine();

            Console.WriteLine("Start Process C and press ENTER to continue.");
            Console.ReadLine();

            mutex.WaitOne();
            using (MemoryMappedViewStream stream = mmf.CreateViewStream())
            {
                BinaryReader reader = new BinaryReader(stream);
                Console.WriteLine("Process A says: {0}", reader.ReadBoolean());
                Console.WriteLine("Process B says: {0}", reader.ReadBoolean());
                Console.WriteLine("Process C says: {0}", reader.ReadBoolean());
            }
            mutex.ReleaseMutex();
        }
    }
}

İşlem B

using System;
using System.IO;
using System.IO.MemoryMappedFiles;
using System.Threading;

class Program
{
    // Process B:
    static void Main(string[] args)
    {
        try
        {
            using (MemoryMappedFile mmf = MemoryMappedFile.OpenExisting("testmap"))
            {

                Mutex mutex = Mutex.OpenExisting("testmapmutex");
                mutex.WaitOne();

                using (MemoryMappedViewStream stream = mmf.CreateViewStream(1, 0))
                {
                    BinaryWriter writer = new BinaryWriter(stream);
                    writer.Write(0);
                }
                mutex.ReleaseMutex();
            }
        }
        catch (FileNotFoundException)
        {
            Console.WriteLine("Memory-mapped file does not exist. Run Process A first.");
        }
    }
}

İşlem C

using System;
using System.IO;
using System.IO.MemoryMappedFiles;
using System.Threading;

class Program
{
    // Process C:
    static void Main(string[] args)
    {
        try
        {
            using (MemoryMappedFile mmf = MemoryMappedFile.OpenExisting("testmap"))
            {

                Mutex mutex = Mutex.OpenExisting("testmapmutex");
                mutex.WaitOne();

                using (MemoryMappedViewStream stream = mmf.CreateViewStream(2, 0))
                {
                    BinaryWriter writer = new BinaryWriter(stream);
                    writer.Write(1);
                }
                mutex.ReleaseMutex();
            }
        }
        catch (FileNotFoundException)
        {
            Console.WriteLine("Memory-mapped file does not exist. Run Process A first, then B.");
        }
    }
}

Açıklamalar

İşlemler arasında veri paylaşmak için kullanabileceğiniz kalıcı olmayan (disk üzerindeki bir dosyayla ilişkili olmayan) bellekle eşlenmiş bir dosya oluşturmak için bu yöntemi kullanın.

Ayrıca bkz.

• Belleğe Eşlenen Dosyalar

CreateNew(String, Int64, MemoryMappedFileAccess)

Kaynak:

MemoryMappedFile.cs

Sistem belleğinde belirtilen kapasiteye ve erişim türüne sahip, belleğe eşlenmiş bir dosya oluşturur.

public static System.IO.MemoryMappedFiles.MemoryMappedFile CreateNew (string? mapName, long capacity, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access);

Parametreler

mapName

String

Bellekle eşlenen dosyaya atanacak veya null işlemler arasında paylaşmayı amaçlamadığınız bir MemoryMappedFile ad.

capacity

Int64

Bellekle eşlenen dosyaya ayrılacak en büyük boyut (bayt cinsinden).

access

MemoryMappedFileAccess

Bellekle eşlenen dosyaya izin verilen erişim türünü belirten numaralandırma değerlerinden biri. Varsayılan değer: ReadWrite.

Döndürülenler

MemoryMappedFile

Belirtilen özelliklere sahip belleğe eşlenmiş bir dosya.

Özel durumlar

ArgumentException

mapName boş bir dizedir.

-veya-

access sabit listesi değeriyle Write salt yazma olarak ayarlanır.

ArgumentOutOfRangeException

capacity sıfırdan küçük veya sıfıra eşit.

-veya-

access geçerli MemoryMappedFileAccess bir sabit listesi değeri değil.

PlatformNotSupportedException

Yalnızca .NET Core ve .NET 5+ : Adlandırılmış bellek eşlenmiş dosyasıyla (null mapNameolmayan bir dosya) yöntemine yapılan çağrılar CreateNew yalnızca Windows işletim sistemlerinde desteklenir.

Açıklamalar

İşlemler arasında veri paylaşmak için kullanabileceğiniz kalıcı olmayan (disk üzerindeki bir dosyayla ilişkili olmayan) bellekle eşlenmiş bir dosya oluşturmak için bu yöntemi kullanın.

Ayrıca bkz.

• Belleğe Eşlenen Dosyalar

CreateNew(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability)

Kaynak:

MemoryMappedFile.cs

Belirtilen ada, kapasiteye, erişim türüne, bellek ayırma seçeneklerine ve devralınabilirliğe sahip, belleğe eşlenmiş bir dosya oluşturur.

public static System.IO.MemoryMappedFiles.MemoryMappedFile CreateNew (string? mapName, long capacity, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access, System.IO.MemoryMappedFiles.MemoryMappedFileOptions options, System.IO.HandleInheritability inheritability);

Parametreler

mapName

String

Bellekle eşlenen dosyaya atanacak veya null işlemler arasında paylaşmayı amaçlamadığınız bir MemoryMappedFile ad.

capacity

Int64

Bellekle eşlenen dosyaya ayrılacak en büyük boyut (bayt cinsinden).

access

MemoryMappedFileAccess

Bellekle eşlenen dosyaya izin verilen erişim türünü belirten numaralandırma değerlerinden biri. Varsayılan değer: ReadWrite.

options

MemoryMappedFileOptions

Bellekle eşlenen dosya için bellek ayırma seçeneklerini belirten sabit listesi değerlerinin bit düzeyinde birleşimi.

inheritability

HandleInheritability

Bellek eşlemeli dosyaya yönelik bir tanıtıcının alt işlem tarafından devralınıp devralınamayacağını belirten bir değer. Varsayılan değer: None.

Döndürülenler

MemoryMappedFile

Belirtilen özelliklere sahip belleğe eşlenmiş bir dosya.

Özel durumlar

ArgumentException

mapName boş bir dizedir.

-veya-

access sabit listesi değeriyle Write salt yazma olarak ayarlanır.

ArgumentOutOfRangeException

capacity sıfırdan küçük veya sıfıra eşit.

-veya-

access geçerli MemoryMappedFileAccess bir sabit listesi değeri değil.

-veya-

inheritability geçerli HandleInheritability bir değer değil.

PlatformNotSupportedException

Yalnızca .NET Core ve .NET 5+ : Adlandırılmış bellek eşlenmiş dosyasıyla (null mapNameolmayan bir dosya) yöntemine yapılan çağrılar CreateNew yalnızca Windows işletim sistemlerinde desteklenir.