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 异常”一节。

MissingSatelliteAssemblyException

默认区域性的资源位于无法找到的附属程序集。有关如何处理此异常的信息，请参阅 ResourceManager 类主题“处理 MissingManifestResourceException 和 MissingSatelliteAssemblyException 异常”一节。

示例

下面的示例使用 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

重要