MemoryMappedFile.OpenExisting Yöntem

Tanım

Ad Alanı:

System.IO.MemoryMappedFiles

Bütünleştirilmiş Kod:

System.IO.MemoryMappedFiles.dll

Sistem belleğinde mevcut adlandırılmış bellek eşlemeli dosyayı açar.

Aşırı Yüklemeler

OpenExisting(String)	Sistem belleğinde belirtilen ada sahip, bellekle eşlenmiş mevcut bir dosyayı açar.
OpenExisting(String, MemoryMappedFileRights)	Sistem belleğinde belirtilen ada ve erişim haklarına sahip, bellekle eşlenmiş mevcut bir dosyayı açar.
OpenExisting(String, MemoryMappedFileRights, HandleInheritability)	Belirtilen ada, erişim haklarına ve sistem belleğinde devralınabilirliğe sahip, bellekle eşlenmiş mevcut bir dosyayı açar.

OpenExisting(String)

Kaynak:

MemoryMappedFile.cs

Sistem belleğinde belirtilen ada sahip, bellekle eşlenmiş mevcut bir dosyayı açar.

public:
 static System::IO::MemoryMappedFiles::MemoryMappedFile ^ OpenExisting(System::String ^ mapName);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.IO.MemoryMappedFiles.MemoryMappedFile OpenExisting (string mapName);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member OpenExisting : string -> System.IO.MemoryMappedFiles.MemoryMappedFile

Public Shared Function OpenExisting (mapName As String) As MemoryMappedFile

Parametreler

mapName

String

Belleğe eşlenen dosyanın adı.

Döndürülenler

MemoryMappedFile

Belirtilen ada sahip belleğe eşlenmiş bir dosya.

Öznitelikler

SupportedOSPlatformAttribute

Özel durumlar

ArgumentNullException

mapName, null değeridir.

ArgumentException

mapName boş bir dizedir.

FileNotFoundException

için mapName belirtilen dosya yok.

Örnekler

Kalıcı Memory-Mapped Dosyası Açma

Aşağıdaki örnek, diskteki bir dosyadan zaten oluşturulmuş adlı ImgA bellekle eşlenmiş bir dosyayı açar (yöntem örneğinde CreateFromFile(String) gösterildiği gibi).

using System;
using System.IO.MemoryMappedFiles;
using System.Runtime.InteropServices;

class Program
{
    static void Main(string[] args)
    {
        // Assumes another process has created the memory-mapped file.
        using (var mmf = MemoryMappedFile.OpenExisting("ImgA"))
        {
            using (var accessor = mmf.CreateViewAccessor(4000000, 2000000))
            {
                int colorSize = Marshal.SizeOf(typeof(MyColor));
                MyColor color;

                // Make changes to the view.
                for (long i = 0; i < 1500000; i += colorSize)
                {
                    accessor.Read(i, out color);
                    color.Brighten(20);
                    accessor.Write(i, ref color);
                }
            }
        }
    }
}

public struct MyColor
{
    public short Red;
    public short Green;
    public short Blue;
    public short Alpha;

    // Make the view brigher.
    public void Brighten(short value)
    {
        Red = (short)Math.Min(short.MaxValue, (int)Red + value);
        Green = (short)Math.Min(short.MaxValue, (int)Green + value);
        Blue = (short)Math.Min(short.MaxValue, (int)Blue + value);
        Alpha = (short)Math.Min(short.MaxValue, (int)Alpha + value);
    }
}

Imports System.IO.MemoryMappedFiles
Imports System.Runtime.InteropServices

Class Program
    Public Shared Sub Main(ByVal args As String())
        ' Assumes another process has created the memory-mapped file.
        Using mmf = MemoryMappedFile.OpenExisting("ImgA")
            Using accessor = mmf.CreateViewAccessor(4000000, 2000000)
                Dim colorSize As Integer = Marshal.SizeOf(GetType(MyColor))
                Dim color As MyColor

                ' Make changes to the view.
                Dim i As Long = 0
                While i < 1500000
                    accessor.Read(i, color)
                    color.Brighten(30)
                    accessor.Write(i, color)
                    i += colorSize
                End While
            End Using
        End Using
    End Sub
End Class

Public Structure MyColor
    Public Red As Short
    Public Green As Short
    Public Blue As Short
    Public Alpha As Short

    ' Make the view brigher.
    Public Sub Brighten(ByVal value As Short)
        Red = CShort(Math.Min(Short.MaxValue, CInt(Red) + value))
        Green = CShort(Math.Min(Short.MaxValue, CInt(Green) + value))
        Blue = CShort(Math.Min(Short.MaxValue, CInt(Blue) + value))
        Alpha = CShort(Math.Min(Short.MaxValue, CInt(Alpha) + value))
    End Sub
End Structure

Kalıcı Olmayan Memory-Mapped Dosyası Açma

Aşağıdaki örnek, işlemler arası iletişim için kullanılan belleğe eşlenmiş bir dosyayı açar. Bu kod örneği, yöntemi için CreateNew(String, Int64) sağlanan daha büyük bir örneğin parçasıdır.

Açıklamalar

Bellekle eşlenen dosya kalıcı bellekle eşlenmiş bir dosya (disk üzerindeki bir dosyayla ilişkili) veya kalıcı olmayan bir dosya olabilir.

Ayrıca bkz.

• Belleğe Eşlenen Dosyalar

OpenExisting(String, MemoryMappedFileRights)

Kaynak:

MemoryMappedFile.cs

Sistem belleğinde belirtilen ada ve erişim haklarına sahip, bellekle eşlenmiş mevcut bir dosyayı açar.

public:
 static System::IO::MemoryMappedFiles::MemoryMappedFile ^ OpenExisting(System::String ^ mapName, System::IO::MemoryMappedFiles::MemoryMappedFileRights desiredAccessRights);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.IO.MemoryMappedFiles.MemoryMappedFile OpenExisting (string mapName, System.IO.MemoryMappedFiles.MemoryMappedFileRights desiredAccessRights);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member OpenExisting : string * System.IO.MemoryMappedFiles.MemoryMappedFileRights -> System.IO.MemoryMappedFiles.MemoryMappedFile

Public Shared Function OpenExisting (mapName As String, desiredAccessRights As MemoryMappedFileRights) As MemoryMappedFile

Parametreler

mapName

String

Açılacak bellekle eşlenen dosyanın adı.

desiredAccessRights

MemoryMappedFileRights

Bellekle eşlenen dosyaya uygulanacak erişim haklarını belirten numaralandırma değerlerinden biri.

Döndürülenler

MemoryMappedFile

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

Öznitelikler

SupportedOSPlatformAttribute

Özel durumlar

ArgumentNullException

mapName, null değeridir.

ArgumentException

mapName boş bir dizedir.

ArgumentOutOfRangeException

desiredAccessRights geçerli MemoryMappedFileRights bir sabit listesi değeri değil.

FileNotFoundException

için mapName belirtilen dosya yok.

Ayrıca bkz.

• Belleğe Eşlenen Dosyalar

OpenExisting(String, MemoryMappedFileRights, HandleInheritability)

Kaynak:

MemoryMappedFile.cs

Belirtilen ada, erişim haklarına ve sistem belleğinde devralınabilirliğe sahip, bellekle eşlenmiş mevcut bir dosyayı açar.

public:
 static System::IO::MemoryMappedFiles::MemoryMappedFile ^ OpenExisting(System::String ^ mapName, System::IO::MemoryMappedFiles::MemoryMappedFileRights desiredAccessRights, System::IO::HandleInheritability inheritability);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.IO.MemoryMappedFiles.MemoryMappedFile OpenExisting (string mapName, System.IO.MemoryMappedFiles.MemoryMappedFileRights desiredAccessRights, System.IO.HandleInheritability inheritability);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member OpenExisting : string * System.IO.MemoryMappedFiles.MemoryMappedFileRights * System.IO.HandleInheritability -> System.IO.MemoryMappedFiles.MemoryMappedFile

Public Shared Function OpenExisting (mapName As String, desiredAccessRights As MemoryMappedFileRights, inheritability As HandleInheritability) As MemoryMappedFile

Parametreler

mapName

String

Açılacak bellekle eşlenen dosyanın adı.

desiredAccessRights

MemoryMappedFileRights

Bellekle eşlenen dosyaya uygulanacak erişim haklarını belirten numaralandırma değerlerinden biri.

inheritability

HandleInheritability

Bellek eşlemeli dosyanın tanıtıcısının alt işlem tarafından devralınıp devralınamayacağını belirten numaralandırma değerlerinden biri. Varsayılan değer: None.

Döndürülenler

MemoryMappedFile

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

Öznitelikler

SupportedOSPlatformAttribute

Özel durumlar

ArgumentNullException

mapName, null değeridir.

ArgumentException

mapName boş bir dizedir.

ArgumentOutOfRangeException

desiredAccessRights geçerli MemoryMappedFileRights bir sabit listesi değeri değil.

-veya-

inheritability geçerli HandleInheritability bir sabit listesi değeri değil.

UnauthorizedAccessException

İstenen erişim, bellekle eşlenen dosya için geçersiz.

FileNotFoundException

için mapName belirtilen dosya yok.

Ayrıca bkz.

• Belleğe Eşlenen Dosyalar