ResourceManager.GetStream 方法

参考

定义

命名空间:: System.Resources

程序集:: System.Runtime.dll

程序集:: System.Resources.ResourceManager.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

从指定的资源返回非托管内存流对象。

重载

GetStream(String)	从指定的资源返回非托管内存流对象。
GetStream(String, CultureInfo)	使用指定的区域性从指定资源返回非托管内存流对象。

GetStream(String)

Source:: ResourceManager.cs

Source:: ResourceManager.cs

Source:: ResourceManager.cs

重要

此 API 不符合 CLS。

从指定的资源返回非托管内存流对象。

public:
 System::IO::UnmanagedMemoryStream ^ GetStream(System::String ^ name);

public System.IO.UnmanagedMemoryStream? GetStream (string name);

public System.IO.UnmanagedMemoryStream GetStream (string name);

[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public System.IO.UnmanagedMemoryStream GetStream (string name);

[System.Runtime.InteropServices.ComVisible(false)]
public System.IO.UnmanagedMemoryStream GetStream (string name);

member this.GetStream : string -> System.IO.UnmanagedMemoryStream

[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.GetStream : string -> System.IO.UnmanagedMemoryStream

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.GetStream : string -> System.IO.UnmanagedMemoryStream

Public Function GetStream (name As String) As UnmanagedMemoryStream

参数

name: String

资源的名称。

UnmanagedMemoryStream

表示资源的非托管内存流对象。

属性: CLSCompliantAttribute ComVisibleAttribute

例外

InvalidOperationException

指定资源的值不是 MemoryStream 对象。

ArgumentNullException

name null。

MissingManifestResourceException

找不到可用资源集，并且没有默认资源。有关如何处理此异常的信息，请参阅 ResourceManager 类主题中的“处理 MissingManifestResourceException 和 MissingSatelliteAssemblyException Exceptions”部分。

MissingSatelliteAssemblyException

默认区域性的资源驻留在找不到的附属程序集中。有关如何处理此异常的信息，请参阅 ResourceManager 类主题中的“处理 MissingManifestResourceException 和 MissingSatelliteAssemblyException Exceptions”部分。

示例

以下示例使用 GetStream(String) 方法检索应用打开的初始窗口中使用的位图。名为 CreateResources.cs（for C#）或CreateResources.vb（for Visual Basic）的文件中的以下源代码生成一个名为 AppResources.resx 的 .resx 文件，其中包含序列化的图像。在这种情况下，将从名为 SplashScreen.jpg; 的文件加载映像;可以修改文件名以替换自己的映像。

using System;
using System.Drawing;
using System.Drawing.Imaging;
using System.IO;
using System.Resources;

public class Example
{
   public static void Main()
   {
      Bitmap bmp = new Bitmap(@".\SplashScreen.jpg");
      MemoryStream imageStream = new MemoryStream();
      bmp.Save(imageStream, ImageFormat.Jpeg);

      ResXResourceWriter writer = new ResXResourceWriter("AppResources.resx");
      writer.AddResource("SplashScreen", imageStream);
      writer.Generate();
      writer.Close();
   }
}

Imports System.Drawing
Imports System.Drawing.Imaging
Imports System.IO
Imports System.Resources

Module Example
   Public Sub Main()
      Dim bmp As New Bitmap(".\SplashScreen.jpg")
      Dim imageStream As New MemoryStream()
      bmp.Save(imageStream, ImageFormat.Jpeg)
      
      Dim writer As New ResXResourceWriter("AppResources.resx")
      writer.AddResource("SplashScreen", imageStream)
      writer.Generate()
      writer.Close()      
   End Sub
End Module

以下代码来自名为 GetStream.cs（for C#）或 GetStream.vb（for Visual Basic）的文件，然后检索资源并在 System.Windows.Forms.PictureBox 控件中显示图像。

using System;
using System.Drawing;
using System.IO;
using System.Resources;
using System.Windows.Forms;

public class Example
{
   public static void Main()
   {
      ResourceManager rm = new ResourceManager("AppResources", typeof(Example).Assembly);
      Bitmap screen = (Bitmap) Image.FromStream(rm.GetStream("SplashScreen"));

      Form frm = new Form();
      frm.Size = new Size(300, 300);

      PictureBox pic = new PictureBox();
      pic.Bounds = frm.RestoreBounds;
      pic.BorderStyle = BorderStyle.Fixed3D;
      pic.Image = screen;
      pic.SizeMode = PictureBoxSizeMode.StretchImage;

      frm.Controls.Add(pic);
      pic.Anchor = AnchorStyles.Top | AnchorStyles.Bottom |
                   AnchorStyles.Left | AnchorStyles.Right;

      frm.ShowDialog();
   }
}

Imports System.Drawing
Imports System.IO
Imports System.Resources
Imports System.Windows.Forms

Module Example
   Public Sub Main()
      Dim rm As New ResourceManager("AppResources", GetType(Example).Assembly)
      Dim screen As Bitmap = CType(Image.FromStream(rm.GetStream("SplashScreen")), Bitmap)
      
      Dim frm As New Form()
      frm.Size = new Size(300, 300)

      Dim pic As New PictureBox()
      pic.Bounds = frm.RestoreBounds
      pic.BorderStyle = BorderStyle.Fixed3D 
      pic.Image = screen
      pic.SizeMode = PictureBoxSizeMode.StretchImage

      frm.Controls.Add(pic)
      pic.Anchor = AnchorStyles.Top Or AnchorStyles.Bottom Or
                   AnchorStyles.Left Or AnchorStyles.Right

      frm.ShowDialog()
   End Sub
End Module

可以使用以下批处理文件生成 C# 示例。对于 Visual Basic，请将 csc 更改为 vbc，并将源代码文件的扩展从 .cs 更改为 .vb。

csc CreateResources.cs
CreateResources

resgen AppResources.resx

csc GetStream.cs /resource:AppResources.resources

注解

GetStream 方法采用存储为 MemoryStream 对象的资源的名称，获取 Object 资源的值，并返回 UnmanagedMemoryStream 对象。它要求你直接使用字节流，然后转换为对象。此方法主要用于性能原因：将资源检索为字节流而不是显式对象可以提高性能。

返回的资源已本地化为当前线程的 UI 区域性，该区域性由 CultureInfo.CurrentUICulture 属性定义。如果资源未针对该区域性进行本地化，资源管理器将使用回退规则来加载适当的资源。如果未找到可用本地化资源集，ResourceManager 会回退到默认区域性的资源上。如果未找到默认区域性的资源集，该方法将引发 MissingManifestResourceException 异常;如果预期资源集驻留在附属程序集中，则引发 MissingSatelliteAssemblyException 异常。如果资源管理器可以加载适当的资源集，但找不到名为 name的资源，该方法将返回 null。

IgnoreCase 属性确定 name 与资源名称的比较是否不区分大小写（默认值）或区分大小写。

适用于

GetStream(String, CultureInfo)

Source:: ResourceManager.cs

Source:: ResourceManager.cs

Source:: ResourceManager.cs

重要