CreateNew() [3/3]

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

inlinestatic

Definition at line 197 of file MemoryMappedFile.cs.

    {
        if (mapName != null && mapName.Length == 0)
        {
            throw new ArgumentException(System.SR.Argument_MapNameEmptyString);
        }
        if (capacity <= 0)
        {
            throw new ArgumentOutOfRangeException("capacity", System.SR.ArgumentOutOfRange_NeedPositiveNumber);
        }
        if (IntPtr.Size == 4 && capacity > uint.MaxValue)
        {
            throw new ArgumentOutOfRangeException("capacity", System.SR.ArgumentOutOfRange_CapacityLargerThanLogicalAddressSpaceNotAllowed);
        }
        switch (access)
        {
        default:
            throw new ArgumentOutOfRangeException("access");
        case MemoryMappedFileAccess.Write:
            throw new ArgumentException(System.SR.Argument_NewMMFWriteAccessNotAllowed, "access");
        case MemoryMappedFileAccess.ReadWrite:
        case MemoryMappedFileAccess.Read:
        case MemoryMappedFileAccess.CopyOnWrite:
        case MemoryMappedFileAccess.ReadExecute:
        case MemoryMappedFileAccess.ReadWriteExecute:
        {
            if (((uint)options & 0xFBFFFFFFu) != 0)
            {
                throw new ArgumentOutOfRangeException("options");
            }
            if (inheritability < HandleInheritability.None || inheritability > HandleInheritability.Inheritable)
            {
                throw new ArgumentOutOfRangeException("inheritability");
            }
            SafeMemoryMappedFileHandle handle = CreateCore(null, mapName, inheritability, access, options, capacity);
            return new MemoryMappedFile(handle);
        }
        }
    }

References System.IO.MemoryMappedFiles.MemoryMappedFile.MemoryMappedFile(), System.SR.Argument_MapNameEmptyString, System.SR.Argument_NewMMFWriteAccessNotAllowed, System.SR.ArgumentOutOfRange_CapacityLargerThanLogicalAddressSpaceNotAllowed, System.SR.ArgumentOutOfRange_NeedPositiveNumber, System.capacity, System.IO.MemoryMappedFiles.MemoryMappedFile.CreateCore(), System.handle, System.options, and System.IntPtr.Size.