ResourceManager.GetStream ResourceManager.GetStream ResourceManager.GetStream ResourceManager.GetStream Method

Definición

Devuelve un objeto de secuencia de memoria no administrada de un recurso especificado. Returns an unmanaged memory stream object from a specified resource.

Sobrecargas

GetStream(String) GetStream(String) GetStream(String) GetStream(String)

Devuelve un objeto de secuencia de memoria no administrada del recurso especificado. Returns an unmanaged memory stream object from the specified resource.

GetStream(String, CultureInfo) GetStream(String, CultureInfo) GetStream(String, CultureInfo) GetStream(String, CultureInfo)

Devuelve un objeto de secuencia de memoria no administrada a partir del recurso especificado, usando la referencia cultural especificada. Returns an unmanaged memory stream object from the specified resource, using the specified culture.

GetStream(String) GetStream(String) GetStream(String) GetStream(String)

Importante

Esta API no es conforme a CLS.

Devuelve un objeto de secuencia de memoria no administrada del recurso especificado. Returns an unmanaged memory stream object from the specified resource.

public:
 System::IO::UnmanagedMemoryStream ^ GetStream(System::String ^ name);
[System.Runtime.InteropServices.ComVisible(false)]
[System.CLSCompliant(false)]
public System.IO.UnmanagedMemoryStream GetStream (string name);
member this.GetStream : string -> System.IO.UnmanagedMemoryStream
Public Function GetStream (name As String) As UnmanagedMemoryStream

Parámetros

name
String String String String

Nombre de un recurso. The name of a resource.

Devoluciones

Un objeto de secuencia de memoria no administrada que representa un recurso. An unmanaged memory stream object that represents a resource .

Excepciones

El valor del recurso especificado no es un objeto MemoryStream. The value of the specified resource is not a MemoryStream object.

No se han encontrado conjuntos de recursos que se puedan utilizar y no hay recursos predeterminados. No usable set of resources is found, and there are no default resources. Para obtener información sobre cómo administrar esta excepción, vea la sección "Administrar las excepciones MissingManifestResourceException y MissingSatelliteAssemblyException" en el tema de la clase ResourceManager. For information about how to handle this exception, see the "Handling MissingManifestResourceException and MissingSatelliteAssemblyException Exceptions" section in the ResourceManager class topic.

Los recursos de la referencia cultural predeterminada residen en un ensamblado satélite que no se encuentra. The default culture's resources reside in a satellite assembly that could not be found. Para obtener información sobre cómo administrar esta excepción, vea la sección "Administrar las excepciones MissingManifestResourceException y MissingSatelliteAssemblyException" en el tema de la clase ResourceManager. For information about how to handle this exception, see the "Handling MissingManifestResourceException and MissingSatelliteAssemblyException Exceptions" section in the ResourceManager class topic.

Ejemplos

En el ejemplo siguiente se usa el método GetStream(String) para recuperar un mapa de bits que se emplea en la ventana de inicio de una aplicación.The following example uses the GetStream(String) method to retrieve a bitmap that is used in an app's opening splash window. El siguiente código desde un archivo denominado fuente CreateResources.cs (para C#) o CreateResources.vb (para Visual Basic) genera un archivo .resx denominado AppResources.resx que contiene la imagen serializada.The following source code from a file named CreateResources.cs (for C#) or CreateResources.vb (for Visual Basic) generates a .resx file named AppResources.resx that contains the serialized image. En este caso, la imagen se carga desde un archivo denominado SplashScreen.jpg; puede modificar el nombre del archivo para sustituir su propia imagen.In this case, the image is loaded from a file named SplashScreen.jpg; you can modify the file name to substitute your own image.

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

El siguiente código de un archivo denominado GetStream.cs (para C#) o GetStream.vb (para Visual Basic), a continuación, recupera el recurso y muestra la imagen en un System.Windows.Forms.PictureBox control.The following code from a file named GetStream.cs (for C#) or GetStream.vb (for Visual Basic) then retrieves the resource and displays the image in a System.Windows.Forms.PictureBox control.

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

Puede usar el siguiente archivo por lotes para compilar el ejemplo de C#.You can use the following batch file to build the C# example. Visual Basic, cambie csc a vbcy cambie la extensión de archivo de código fuente de .cs a .vb...For Visual Basic, change csc to vbc, and change the extension of the source code file from .cs to .vb..


csc CreateResources.cs  
CreateResources  

resgen AppResources.resx  

csc GetStream.cs /resource:AppResources.resources  

Comentarios

El GetStream método toma el nombre de un recurso que se almacena como un MemoryStream de objetos, obtiene el valor de la Object recursos y devuelve un UnmanagedMemoryStream objeto.The GetStream method takes the name of a resource that is stored as a MemoryStream object, gets the value of the Object resource, and returns an UnmanagedMemoryStream object. Requiere que trabaje directamente con una secuencia de bytes, que, a continuación, convertir en un objeto.It requires that you work directly with a stream of bytes, which you then convert to an object. Este método es útil principalmente por motivos de rendimiento: recuperación de un recurso como una secuencia de bytes en lugar de un objeto explícito puede mejorar el rendimiento.This method is useful primarily for performance reasons: Retrieving a resource as a byte stream instead of an explicit object can improve performance.

El recurso devuelto se adapta a la referencia cultural de interfaz de usuario del subproceso actual, que se define mediante el CultureInfo.CurrentUICulture propiedad.The returned resource is localized for the UI culture of the current thread, which is defined by the CultureInfo.CurrentUICulture property. Si no se encuentra el recurso para esa referencia cultural, el Administrador de recursos usa reglas de reserva para cargar un recurso adecuado.If the resource is not localized for that culture, the resource manager uses fallback rules to load an appropriate resource. Si no se encuentra ningún conjunto de recursos localizados utilizable, el ResourceManager recurre a los recursos de la referencia cultural de forma predeterminada.If no usable set of localized resources is found, the ResourceManager falls back on the default culture's resources. Si no se encuentra un conjunto de recursos para la referencia cultural predeterminada, el método produce una MissingManifestResourceException excepción o, si se espera que el conjunto de recursos que residan en un ensamblado satélite, una MissingSatelliteAssemblyException excepción.If a resource set for the default culture is not found, the method throws a MissingManifestResourceException exception or, if the resource set is expected to reside in a satellite assembly, a MissingSatelliteAssemblyException exception. Si el Administrador de recursos puede cargar un recurso adecuado establecer pero no se puede encontrar un recurso denominado name, el método devuelve null.If the resource manager can load an appropriate resource set but cannot find a resource named name, the method returns null.

El IgnoreCase propiedad determina si la comparación de name con los nombres de recursos, distingue mayúsculas de minúsculas (predeterminado) o entre mayúsculas y minúsculas.The IgnoreCase property determines whether the comparison of name with the names of resources is case-insensitive (the default) or case-sensitive.

Seguridad

ReflectionPermission
Cuando se invoca en tiempo de ejecución a través de mecanismos como InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]). when invoked late-bound through mechanisms such as InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]). Enumeración asociada: MemberAccess. Associated enumeration: MemberAccess.

GetStream(String, CultureInfo) GetStream(String, CultureInfo) GetStream(String, CultureInfo) GetStream(String, CultureInfo)

Importante

Esta API no es conforme a CLS.

Devuelve un objeto de secuencia de memoria no administrada a partir del recurso especificado, usando la referencia cultural especificada. Returns an unmanaged memory stream object from the specified resource, using the specified culture.

public:
 System::IO::UnmanagedMemoryStream ^ GetStream(System::String ^ name, System::Globalization::CultureInfo ^ culture);
[System.Runtime.InteropServices.ComVisible(false)]
[System.CLSCompliant(false)]
public System.IO.UnmanagedMemoryStream GetStream (string name, System.Globalization.CultureInfo culture);
member this.GetStream : string * System.Globalization.CultureInfo -> System.IO.UnmanagedMemoryStream
Public Function GetStream (name As String, culture As CultureInfo) As UnmanagedMemoryStream

Parámetros

name
String String String String

Nombre de un recurso. The name of a resource.

culture
CultureInfo CultureInfo CultureInfo CultureInfo

Objeto que especifica la referencia cultural que se debe usar para la búsqueda de recursos. An object that specifies the culture to use for the resource lookup. Si culture es null, se usa la referencia cultural del subproceso actual. If culture is null, the culture for the current thread is used.

Devoluciones

Objeto de secuencia de memoria no administrada que representa un recurso. An unmanaged memory stream object that represents a resource.

Excepciones

El valor del recurso especificado no es un objeto MemoryStream. The value of the specified resource is not a MemoryStream object.

No se han encontrado conjuntos de recursos que se puedan utilizar y no hay recursos predeterminados. No usable set of resources is found, and there are no default resources. Para obtener información sobre cómo administrar esta excepción, vea la sección "Administrar las excepciones MissingManifestResourceException y MissingSatelliteAssemblyException" en el tema de la clase ResourceManager. For information about how to handle this exception, see the "Handling MissingManifestResourceException and MissingSatelliteAssemblyException Exceptions" section in the ResourceManager class topic.

Los recursos de la referencia cultural predeterminada residen en un ensamblado satélite que no se encuentra. The default culture's resources reside in a satellite assembly that could not be found. Para obtener información sobre cómo administrar esta excepción, vea la sección "Administrar las excepciones MissingManifestResourceException y MissingSatelliteAssemblyException" en el tema de la clase ResourceManager. For information about how to handle this exception, see the "Handling MissingManifestResourceException and MissingSatelliteAssemblyException Exceptions" section in the ResourceManager class topic.

Comentarios

El GetStream método toma el nombre de un recurso que se almacena como un MemoryStream de objetos, obtiene el valor de la Object recursos y devuelve un UnmanagedMemoryStream objeto.The GetStream method takes the name of a resource that is stored as a MemoryStream object, gets the value of the Object resource, and returns an UnmanagedMemoryStream object. Requiere que trabaje directamente con una secuencia de bytes, que, a continuación, convertir en un objeto.It requires that you work directly with a stream of bytes, which you then convert to an object. Este método es útil principalmente por motivos de rendimiento: recuperación de un recurso como una secuencia de bytes en lugar de un objeto explícito puede mejorar el rendimiento.This method is useful primarily for performance reasons: Retrieving a resource as a byte stream instead of an explicit object can improve performance.

El recurso devuelto se adapta a la referencia cultural especificada por culture, o para la referencia cultural especificada por el CultureInfo.CurrentUICulture propiedad si culture es null.The returned resource is localized for the culture that is specified by culture, or for the culture that is specified by the CultureInfo.CurrentUICulture property if culture is null. Si no se encuentra el recurso para esa referencia cultural, el Administrador de recursos usa reglas de reserva para cargar un recurso adecuado.If the resource is not localized for that culture, the resource manager uses fallback rules to load an appropriate resource. Si no se encuentra ningún conjunto de recursos localizados utilizable, el ResourceManager recurre a los recursos de la referencia cultural de forma predeterminada.If no usable set of localized resources is found, the ResourceManager falls back on the default culture's resources. Si no se encuentra un conjunto de recursos para la referencia cultural predeterminada, el método produce una MissingManifestResourceException excepción o, si se espera que el conjunto de recursos que residan en un ensamblado satélite, una MissingSatelliteAssemblyException excepción.If a resource set for the default culture is not found, the method throws a MissingManifestResourceException exception or, if the resource set is expected to reside in a satellite assembly, a MissingSatelliteAssemblyException exception. Si el Administrador de recursos puede cargar un recurso adecuado establecer pero no se puede encontrar un recurso denominado name, el método devuelve null.If the resource manager can load an appropriate resource set but cannot find a resource named name, the method returns null.

El IgnoreCase propiedad determina si la comparación de name con los nombres de recursos, distingue mayúsculas de minúsculas (predeterminado) o entre mayúsculas y minúsculas.The IgnoreCase property determines whether the comparison of name with the names of resources is case-insensitive (the default) or case-sensitive.

Seguridad

ReflectionPermission
Cuando se invoca en tiempo de ejecución a través de mecanismos como InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]). when invoked late-bound through mechanisms such as InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]). Enumeración asociada: MemberAccess. Associated enumeration: MemberAccess.

Se aplica a