UnmanagedMemoryStream 类

定义

命名空间:

System.IO

程序集:

System.Runtime.dll

Source:

UnmanagedMemoryStream.cs

重要

此 API 不符合 CLS。

提供从托管代码访问非托管内存块的访问权限。

C#

public class UnmanagedMemoryStream : System.IO.Stream

继承

Object

MarshalByRefObject

Stream

UnmanagedMemoryStream

派生

System.IO.MemoryMappedFiles.MemoryMappedViewStream

示例

下面的代码示例演示如何使用 UnmanagedMemoryStream 类从非托管内存读取和写入。 使用 Marshal 类分配和取消分配非托管内存块。

C#

// Note: you must compile this sample using the unsafe flag.
// From the command line, type the following: csc sample.cs /unsafe

using System;
using System.IO;
using System.Text;
using System.Runtime.InteropServices;

unsafe class TestWriter
{
    static void Main()
    {
        // Create some data to read and write.
        byte[] message = UnicodeEncoding.Unicode.GetBytes("Here is some data.");

        // Allocate a block of unmanaged memory and return an IntPtr object.	
        IntPtr memIntPtr = Marshal.AllocHGlobal(message.Length);

        // Get a byte pointer from the IntPtr object.
        byte* memBytePtr = (byte*)memIntPtr.ToPointer();

        // Create an UnmanagedMemoryStream object using a pointer to unmanaged memory.
        UnmanagedMemoryStream writeStream = new UnmanagedMemoryStream(memBytePtr, message.Length, message.Length, FileAccess.Write);

        // Write the data.
        writeStream.Write(message, 0, message.Length);

        // Close the stream.
        writeStream.Close();

        // Create another UnmanagedMemoryStream object using a pointer to unmanaged memory.
        UnmanagedMemoryStream readStream = new UnmanagedMemoryStream(memBytePtr, message.Length, message.Length, FileAccess.Read);

        // Create a byte array to hold data from unmanaged memory.
        byte[] outMessage = new byte[message.Length];

        // Read from unmanaged memory to the byte array.
        readStream.Read(outMessage, 0, message.Length);

        // Close the stream.
        readStream.Close();

        // Display the data to the console.
        Console.WriteLine(UnicodeEncoding.Unicode.GetString(outMessage));

        // Free the block of unmanaged memory.
        Marshal.FreeHGlobal(memIntPtr);

        Console.ReadLine();
    }
}

注解

此类支持使用基于流的现有模型访问非托管内存，并且不需要将非托管内存中的内容复制到堆。

备注

此类型实现 IDisposable 接口，但实际上没有任何要释放的资源。 这意味着不需要直接调用 Dispose() 或使用 using（在 C# 中）或 Using（在 Visual Basic 中）等语言构造来释放它。

构造函数

UnmanagedMemoryStream()	初始化 UnmanagedMemoryStream 类的新实例。
UnmanagedMemoryStream(Byte*, Int64, Int64, FileAccess)	使用指定的位置、内存长度、总内存量和文件访问值初始化 UnmanagedMemoryStream 类的新实例。
UnmanagedMemoryStream(Byte*, Int64)	使用指定的位置和内存长度初始化 UnmanagedMemoryStream 类的新实例。
UnmanagedMemoryStream(SafeBuffer, Int64, Int64, FileAccess)	使用指定的偏移量、长度和文件访问初始化安全缓冲区中 UnmanagedMemoryStream 类的新实例。
UnmanagedMemoryStream(SafeBuffer, Int64, Int64)	使用指定的偏移量和长度初始化安全缓冲区中 UnmanagedMemoryStream 类的新实例。

属性

CanRead	获取一个值，该值指示流是否支持读取。
CanSeek	获取一个值，该值指示流是否支持查找。
CanTimeout	获取一个值，该值确定当前流是否可以超时。 (继承自 Stream)
CanWrite	获取一个值，该值指示流是否支持写入。
Capacity	获取流长度（大小）或分配给流的内存总量（容量）。
Length	获取流中的数据长度。
Position	获取或设置流中的当前位置。
PositionPointer	获取或设置基于流中当前位置的流指向流的字节指针。
ReadTimeout	获取或设置一个值（以毫秒为单位），该值确定流在超时前尝试读取的时间。 (继承自 Stream)
WriteTimeout	获取或设置一个值（以毫秒为单位），该值确定流在超时之前尝试写入的时间。 (继承自 Stream)

方法

BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)	开始异步读取操作。 （请考虑改用 ReadAsync(Byte[], Int32, Int32)。 (继承自 Stream)
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)	开始异步写入操作。 （请考虑改用 WriteAsync(Byte[], Int32, Int32)。 (继承自 Stream)
Close()	关闭当前流并释放与当前流关联的任何资源（如套接字和文件句柄）。 请确保流已正确释放，而不是调用此方法。 (继承自 Stream)
CopyTo(Stream, Int32)	从当前流中读取字节，并使用指定的缓冲区大小将其写入另一个流。 这两个流位置都是按复制的字节数进行高级的。 (继承自 Stream)
CopyTo(Stream)	从当前流中读取字节并将其写入另一个流。 这两个流位置都是按复制的字节数进行高级的。 (继承自 Stream)
CopyToAsync(Stream, CancellationToken)	使用指定的取消标记异步读取当前流中的字节并将其写入另一个流。 这两个流位置都是按复制的字节数进行高级的。 (继承自 Stream)
CopyToAsync(Stream, Int32, CancellationToken)	使用指定的缓冲区大小和取消令牌异步读取当前流中的字节并将其写入另一个流。 这两个流位置都是按复制的字节数进行高级的。 (继承自 Stream)
CopyToAsync(Stream, Int32)	使用指定的缓冲区大小异步读取当前流中的字节并将其写入另一个流。 这两个流位置都是按复制的字节数进行高级的。 (继承自 Stream)
CopyToAsync(Stream)	从当前流异步读取字节并将其写入另一个流。 这两个流位置都是按复制的字节数进行高级的。 (继承自 Stream)
CreateObjRef(Type)	创建一个对象，其中包含生成用于与远程对象通信的代理所需的所有相关信息。 (继承自 MarshalByRefObject)
CreateWaitHandle()	已过时. 分配 WaitHandle 对象。 (继承自 Stream)
Dispose()	释放 Stream使用的所有资源。 (继承自 Stream)
Dispose(Boolean)	释放 UnmanagedMemoryStream 使用的非托管资源，并选择性地释放托管资源。
DisposeAsync()	异步释放 Stream使用的非托管资源。 (继承自 Stream)
EndRead(IAsyncResult)	等待挂起的异步读取完成。 （请考虑改用 ReadAsync(Byte[], Int32, Int32)。 (继承自 Stream)
EndWrite(IAsyncResult)	结束异步写入操作。 （请考虑改用 WriteAsync(Byte[], Int32, Int32)。 (继承自 Stream)
Equals(Object)	确定指定的对象是否等于当前对象。 (继承自 Object)
Flush()	重写 Flush() 方法，以便不执行任何操作。
FlushAsync()	异步清除此流的所有缓冲区，并导致任何缓冲数据写入基础设备。 (继承自 Stream)
FlushAsync(CancellationToken)	重写 FlushAsync(CancellationToken) 方法，以便在指定时取消操作，但未执行其他操作。
GetHashCode()	用作默认哈希函数。 (继承自 Object)
GetLifetimeService()	已过时. 检索控制此实例的生存期策略的当前生存期服务对象。 (继承自 MarshalByRefObject)
GetType()	获取当前实例的 Type。 (继承自 Object)
Initialize(Byte*, Int64, Int64, FileAccess)	使用指向非托管内存位置的指针初始化 UnmanagedMemoryStream 类的新实例。
Initialize(SafeBuffer, Int64, Int64, FileAccess)	使用指定的偏移量、长度和文件访问初始化安全缓冲区中 UnmanagedMemoryStream 类的新实例。
InitializeLifetimeService()	已过时. 获取生存期服务对象来控制此实例的生存期策略。 (继承自 MarshalByRefObject)
MemberwiseClone()	创建当前 Object的浅表副本。 (继承自 Object)
MemberwiseClone(Boolean)	创建当前 MarshalByRefObject 对象的浅表副本。 (继承自 MarshalByRefObject)
ObjectInvariant()	已过时. 为 Contract提供支持。 (继承自 Stream)
Read(Byte[], Int32, Int32)	将指定的字节数读入指定的数组。
Read(Span<Byte>)	将此非托管内存流的所有字节读入指定的字节范围。
ReadAsync(Byte[], Int32, Int32, CancellationToken)	将指定的字节数异步读取到指定的数组中。
ReadAsync(Byte[], Int32, Int32)	从当前流异步读取字节序列，并通过读取的字节数推进流中的位置。 (继承自 Stream)
ReadAsync(Memory<Byte>, CancellationToken)	将非托管内存流字节异步读取到内存区域中。
ReadAtLeast(Span<Byte>, Int32, Boolean)	至少从当前流中读取最小字节数，并通过读取的字节数提升流中的位置。 (继承自 Stream)
ReadAtLeastAsync(Memory<Byte>, Int32, Boolean, CancellationToken)	异步读取当前流的最小字节数，按读取的字节数推进流中的位置，并监视取消请求。 (继承自 Stream)
ReadByte()	从流中读取字节并将流中的位置向前推进一个字节，或者在流末尾返回 -1。
ReadExactly(Byte[], Int32, Int32)	从当前流中读取 count 字节数，并提升流中的位置。 (继承自 Stream)
ReadExactly(Span<Byte>)	从当前流中读取字节，并在填充 buffer 之前推进流中的位置。 (继承自 Stream)
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)	从当前流异步读取 count 字节数，推进流中的位置，并监视取消请求。 (继承自 Stream)
ReadExactlyAsync(Memory<Byte>, CancellationToken)	从当前流异步读取字节，在填充 buffer 之前先行流中的位置，并监视取消请求。 (继承自 Stream)
Seek(Int64, SeekOrigin)	将当前流的当前位置设置为给定值。
SetLength(Int64)	将流的长度设置为指定值。
ToString()	返回一个表示当前对象的字符串。 (继承自 Object)
Write(Byte[], Int32, Int32)	使用缓冲区中的数据将字节块写入当前流。
Write(ReadOnlySpan<Byte>)	使用提供的字节范围中的数据将字节块写入当前非托管内存流。
WriteAsync(Byte[], Int32, Int32, CancellationToken)	将字节序列异步写入当前流，按写入的字节数推进此流中的当前位置，并监视取消请求。
WriteAsync(Byte[], Int32, Int32)	以异步方式将字节序列写入当前流，并通过写入的字节数推进此流中的当前位置。 (继承自 Stream)
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	以异步方式将字节范围写入当前流，按写入的字节数推进此流中的当前位置，并监视取消请求。
WriteByte(Byte)	将字节写入文件流中的当前位置。

扩展方法

CopyToAsync(Stream, PipeWriter, CancellationToken)	使用取消令牌从 Stream 异步读取字节并将其写入指定的 PipeWriter。
ConfigureAwait(IAsyncDisposable, Boolean)	配置如何执行从异步可释放项返回的任务的 await。

适用于