MemoryMappedFile.OpenExisting Метод

Ссылка

Определение

Пространство имен:: System.IO.MemoryMappedFiles

Сборка:: System.IO.MemoryMappedFiles.dll

Сборка:: System.Core.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Открывает существующий именованный размещенный в памяти файл в системной памяти.

Перегрузки

OpenExisting(String)	Открывает существующий размещенный в памяти файл с заданным именем в системной памяти.
OpenExisting(String, MemoryMappedFileRights)	Открывает существующий размещенный в памяти файл с заданными именем и правами доступа в системной памяти.
OpenExisting(String, MemoryMappedFileRights, HandleInheritability)	Открывает существующий размещенный в памяти файл с заданными именем, правами доступа и режимом наследования в системной памяти.

OpenExisting(String)

Исходный код:: MemoryMappedFile.cs

Исходный код:: MemoryMappedFile.cs

Исходный код:: MemoryMappedFile.cs

Открывает существующий размещенный в памяти файл с заданным именем в системной памяти.

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

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

public static System.IO.MemoryMappedFiles.MemoryMappedFile OpenExisting (string mapName);

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

static member OpenExisting : string -> System.IO.MemoryMappedFiles.MemoryMappedFile

Public Shared Function OpenExisting (mapName As String) As MemoryMappedFile

Параметры

mapName: String

Имя отображенного в память файла.

Возвращаемое значение

MemoryMappedFile

Размещенный в памяти файл с заданным именем.

Атрибуты: SupportedOSPlatformAttribute

Исключения

ArgumentNullException

mapName имеет значение null.

ArgumentException

Параметр mapName равен пустой строке.

FileNotFoundException

Файл, заданный для mapName, не существует.

Примеры

Открытие сохраненного файла Memory-Mapped

В следующем примере открывается сопоставленный в памяти файл с именем ImgA , который уже был создан из файла на диске (как показано в примере для CreateFromFile(String) метода ).

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

Открытие несохраняемого файла Memory-Mapped

В следующем примере открывается сопоставленный в памяти файл, используемый для межпроцессного взаимодействия. Этот пример кода является частью более крупного примера, предоставленного CreateNew(String, Int64) для метода .

См. также раздел

Файлы, сопоставленные в памяти

Применяется к

OpenExisting(String, MemoryMappedFileRights)

Исходный код:: MemoryMappedFile.cs

Исходный код:: MemoryMappedFile.cs

Исходный код:: MemoryMappedFile.cs

Открывает существующий размещенный в памяти файл с заданными именем и правами доступа в системной памяти.

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);

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

static member OpenExisting : string * System.IO.MemoryMappedFiles.MemoryMappedFileRights -> System.IO.MemoryMappedFiles.MemoryMappedFile

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

Параметры

mapName: String

Имя размещенного в памяти файла, который необходимо открыть.

desiredAccessRights: MemoryMappedFileRights

Одно из значений перечисления, определяющее права доступа, применяемые к размещенному в памяти файлу.

Возвращаемое значение

MemoryMappedFile

Размещенный в памяти файл с заданными характеристиками.

Атрибуты: SupportedOSPlatformAttribute

Исключения

ArgumentNullException

mapName имеет значение null.

ArgumentException

Параметр mapName равен пустой строке.

ArgumentOutOfRangeException

desiredAccessRights не является допустимым значением перечисления MemoryMappedFileRights.

FileNotFoundException

Файл, заданный для mapName, не существует.

См. также раздел

Файлы, сопоставленные в памяти

Применяется к

OpenExisting(String, MemoryMappedFileRights, HandleInheritability)

Исходный код:: MemoryMappedFile.cs

Исходный код:: MemoryMappedFile.cs

Исходный код:: MemoryMappedFile.cs

Открывает существующий размещенный в памяти файл с заданными именем, правами доступа и режимом наследования в системной памяти.

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);

public static System.IO.MemoryMappedFiles.MemoryMappedFile OpenExisting (string mapName, System.IO.MemoryMappedFiles.MemoryMappedFileRights desiredAccessRights, System.IO.HandleInheritability inheritability);

[System.Security.SecurityCritical]
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

static member OpenExisting : string * System.IO.MemoryMappedFiles.MemoryMappedFileRights * System.IO.HandleInheritability -> System.IO.MemoryMappedFiles.MemoryMappedFile

[<System.Security.SecurityCritical>]
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

Параметры

mapName: String

Имя размещенного в памяти файла, который необходимо открыть.

desiredAccessRights: MemoryMappedFileRights

Одно из значений перечисления, определяющее права доступа, применяемые к размещенному в памяти файлу.

inheritability: HandleInheritability

Одно из значений перечисления, определяющее, может ли дескриптор размещенного в памяти файла наследоваться дочерним процессом. Значение по умолчанию — None.