ResourceManager.GetStream Método

Origem:

ResourceManager.cs

Origem:

ResourceManager.cs

Origem:

ResourceManager.cs

Origem:

ResourceManager.cs

Origem:

ResourceManager.cs

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

Parâmetros

Retornos

Um objeto de fluxo de memória não gerenciado que representa um recurso.

Atributos

CLSCompliantAttribute ComVisibleAttribute

Exceções

Exemplos

O exemplo a seguir usa o método GetStream(String) para recuperar um bitmap usado na janela inicial do aplicativo. O código-fonte a seguir de um arquivo chamado CreateResources.cs (para C#) ou CreateResources.vb (para Visual Basic) gera um arquivo .resx chamado AppResources.resx que contém a imagem serializada. Nesse caso, a imagem é carregada de um arquivo chamado SplashScreen.jpg; você pode modificar o nome do arquivo para substituir sua própria imagem.

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

O código a seguir de um arquivo chamado GetStream.cs (para C#) ou GetStream.vb (para Visual Basic) recupera o recurso e exibe a imagem em um controle 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

Você pode usar o arquivo em lote a seguir para criar o exemplo de C#. Para o Visual Basic, altere csc para vbce altere a extensão do arquivo de código-fonte de .cs para .vb.

csc CreateResources.cs
CreateResources

resgen AppResources.resx

csc GetStream.cs /resource:AppResources.resources

Comentários

O método GetStream usa o nome de um recurso armazenado como um objeto MemoryStream, obtém o valor do recurso Object e retorna um objeto UnmanagedMemoryStream. Isso requer que você trabalhe diretamente com um fluxo de bytes, que você converte em um objeto. Esse método é útil principalmente por motivos de desempenho: recuperar um recurso como um fluxo de bytes em vez de um objeto explícito pode melhorar o desempenho.

O recurso retornado é localizado para a cultura da interface do usuário do thread atual, que é definido pela propriedade CultureInfo.CurrentUICulture. Se o recurso não estiver localizado para essa cultura, o gerenciador de recursos usará regras de fallback para carregar um recurso apropriado. Se nenhum conjunto utilizável de recursos localizados for encontrado, o ResourceManager recai sobre os recursos da cultura padrão. Se um conjunto de recursos para a cultura padrão não for encontrado, o método gerará uma exceção MissingManifestResourceException ou, se o conjunto de recursos deve residir em um assembly satélite, uma exceção MissingSatelliteAssemblyException. Se o gerenciador de recursos puder carregar um conjunto de recursos apropriado, mas não puder encontrar um recurso chamado name, o método retornará null.

A propriedade IgnoreCase determina se a comparação de name com os nomes dos recursos não diferencia maiúsculas de minúsculas (o padrão) ou diferencia maiúsculas de minúsculas.

Origem:

ResourceManager.cs

Origem:

ResourceManager.cs

Origem:

ResourceManager.cs

Origem:

ResourceManager.cs

Origem:

ResourceManager.cs

public:
 System::IO::UnmanagedMemoryStream ^ GetStream(System::String ^ name, System::Globalization::CultureInfo ^ culture);

public System.IO.UnmanagedMemoryStream? GetStream(string name, System.Globalization.CultureInfo? culture);

public System.IO.UnmanagedMemoryStream GetStream(string name, System.Globalization.CultureInfo culture);

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

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

member this.GetStream : string * System.Globalization.CultureInfo -> System.IO.UnmanagedMemoryStream

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

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

Public Function GetStream (name As String, culture As CultureInfo) As UnmanagedMemoryStream

Parâmetros

Retornos

Um objeto de fluxo de memória não gerenciado que representa um recurso.

Atributos

CLSCompliantAttribute ComVisibleAttribute

Exceções

Comentários

O método GetStream usa o nome de um recurso armazenado como um objeto MemoryStream, obtém o valor do recurso Object e retorna um objeto UnmanagedMemoryStream. Isso requer que você trabalhe diretamente com um fluxo de bytes, que você converte em um objeto. Esse método é útil principalmente por motivos de desempenho: recuperar um recurso como um fluxo de bytes em vez de um objeto explícito pode melhorar o desempenho.

O recurso retornado é localizado para a cultura especificada por cultureou para a cultura especificada pela propriedade CultureInfo.CurrentUICulture se culture for null. Se o recurso não estiver localizado para essa cultura, o gerenciador de recursos usará regras de fallback para carregar um recurso apropriado. Se nenhum conjunto utilizável de recursos localizados for encontrado, o ResourceManager recai sobre os recursos da cultura padrão. Se um conjunto de recursos para a cultura padrão não for encontrado, o método gerará uma exceção MissingManifestResourceException ou, se o conjunto de recursos deve residir em um assembly satélite, uma exceção MissingSatelliteAssemblyException. Se o gerenciador de recursos puder carregar um conjunto de recursos apropriado, mas não puder encontrar um recurso chamado name, o método retornará null.

A propriedade IgnoreCase determina se a comparação de name com os nomes dos recursos não diferencia maiúsculas de minúsculas (o padrão) ou diferencia maiúsculas de minúsculas.