ResourceReader Constructores

Definición

Inicializa una nueva instancia de la clase ResourceReader.Initializes a new instance of the ResourceReader class.

Sobrecargas

ResourceReader(Stream)

Inicializa una nueva instancia de la clase ResourceReader para el flujo especificado.Initializes a new instance of the ResourceReader class for the specified stream.

ResourceReader(String)

Inicializa una nueva instancia de la clase ResourceReader para el archivo de recursos denominado especificado.Initializes a new instance of the ResourceReader class for the specified named resource file.

Comentarios

> [!IMPORTANT] > Usar una instancia de este objeto con datos que no son de confianza supone un riesgo de seguridad.Using an instance of this object with untrusted data is a security risk. Utilice este objeto solo con datos de confianza.Use this object only with trusted data. Para obtener más información, vea Data Validation (Validación de datos).For more information, see Data Validation..> [!IMPORTANT] > Usar una instancia de este objeto con datos que no son de confianza supone un riesgo de seguridad.Using an instance of this object with untrusted data is a security risk. Utilice este objeto solo con datos de confianza.Use this object only with trusted data. Para obtener más información, vea Data Validation (Validación de datos).For more information, see Data Validation..

ResourceReader(Stream)

Inicializa una nueva instancia de la clase ResourceReader para el flujo especificado.Initializes a new instance of the ResourceReader class for the specified stream.

public:
 ResourceReader(System::IO::Stream ^ stream);
[System.Security.SecurityCritical]
public ResourceReader (System.IO.Stream stream);
new System.Resources.ResourceReader : System.IO.Stream -> System.Resources.ResourceReader

Parámetros

stream
Stream

Flujo de entrada para la lectura de recursos.The input stream for reading resources.

Atributos

Excepciones

El parámetro stream no se puede leer.The stream parameter is not readable.

El parámetro stream es null.The stream parameter is null.

Error de E/S durante el acceso al parámetro stream.An I/O error has occurred while accessing stream.

Ejemplos

En el ejemplo de esta sección se usa el siguiente archivo. txt denominado PatientForm.txt para definir los recursos utilizados por una aplicación.The example in this section uses the following .txt file named PatientForm.txt to define the resources used by an application.

  
Title="Top Pet Animal Clinic"  
Label1="Patient Number:"  
Label2="Pet Name:"  
Label3="Species:"  
Label4="Breed:"  
Label5="Date of Birth:"  
Label6="Age:"  
Label7="Owner:"  
Label8="Address:"  
Label9="Home Phone:"  
Label10="Work Phone:"  
Label11="Mobile Phone:"  
  

Puede compilar el archivo. txt en un archivo. Resources emitiendo el comando siguiente:You can compile the .txt file into a .resources file by issuing the following command:

Resgen PatientForm. txtresgen PatientForm.txt

En el ejemplo siguiente se da por supuesto que el archivo de recursos está incrustado en el ensamblado que contiene el código ejecutable de la aplicación.The following example assumes that the resource file is embedded in the assembly that contains the application's executable code. Recupera un archivo de recursos denominado PatientForm.resources de los ensamblados que se están ejecutando actualmente y muestra el nombre y el valor de cada uno de sus recursos.It retrieves a resource file named PatientForm.resources from the currently executing assemblies and displays the name and value of each of its resources.

using System;
using System.Collections;
using System.IO;
using System.Reflection;
using System.Resources;

public class Example
{
   public static void Main()
   {
      var assem = typeof(Example).Assembly;
      var fs = assem.GetManifestResourceStream("PatientForm.resources");
      var rr = new ResourceReader(fs);
      IDictionaryEnumerator dict = rr.GetEnumerator();
      int ctr = 0;

      while (dict.MoveNext()) {
         ctr++;
         Console.WriteLine("{0:00}: {1} = {2}", ctr, dict.Key, dict.Value);
      }
      rr.Close();
   }
}
// The example displays the following output:
//       01: Label3 = "Species:"
//       02: Label2 = "Pet Name:"
//       03: Label1 = "Patient Number:"
//       04: Label7 = "Owner:"
//       05: Label6 = "Age:"
//       06: Label5 = "Date of Birth:"
//       07: Label4 = "Breed:"
//       08: Label9 = "Home Phone:"
//       09: Label8 = "Address:"
//       10: Title = "Top Pet Animal Clinic"
//       11: Label10 = "Work Phone:"
//       12: Label11 = "Mobile Phone:"
Imports System.Collections
Imports System.IO
Imports System.Reflection
Imports System.Resources

Module Example
   Public Sub Main()
      Dim assem As Assembly = GetType(Example).Assembly
      Dim fs As Stream = assem.GetManifestResourceStream("PatientForm.resources")
      Dim rr As New ResourceReader(fs)
      Dim dict As IDictionaryEnumerator = rr.GetEnumerator
      Dim ctr As Integer

      Do While dict.MoveNext()
         ctr += 1
         Console.WriteLine("{0:00}: {1} = {2}", ctr, dict.Key, dict.Value)
      Loop

      rr.Close()
   End Sub
End Module
' The example displays the following output:
'       01: Label3 = "Species:"
'       02: Label2 = "Pet Name:"
'       03: Label1 = "Patient Number:"
'       04: Label7 = "Owner:"
'       05: Label6 = "Age:"
'       06: Label5 = "Date of Birth:"
'       07: Label4 = "Breed:"
'       08: Label9 = "Home Phone:"
'       09: Label8 = "Address:"
'       10: Title = "Top Pet Animal Clinic"
'       11: Label10 = "Work Phone:"
'       12: Label11 = "Mobile Phone:"

Si el C# ejemplo se denomina Example.cs, puede compilarlo con el siguiente comando:If the C# example is named Example.cs, you can compile it by using the following command:

CSC Example.cs/res: PatientForm. Resourcescsc Example.cs /res:PatientForm.resources

Si el ejemplo de Visual Basic se denomina Example.vb, puede compilarlo con el siguiente comando:If the Visual Basic example is named Example.vb, you can compile it by using the following command:

Ejemplo de VBC. VB/res: PatientForm. Resourcesvbc Example.vb /res:PatientForm.resources

Comentarios

El constructor ResourceReader(Stream) crea una instancia de un objeto ResourceReader que recupera recursos de un archivo. Resources independiente o de un archivo. Resources que está incrustado en un ensamblado.The ResourceReader(Stream) constructor instantiates a ResourceReader object that retrieves resources either from a standalone .resources file or from a .resources file that is embedded in an assembly. Para leer de un archivo. Resources independiente, cree una instancia de un objeto Stream y páselo al constructor ResourceReader(Stream).To read from a standalone .resources file, instantiate a Stream object and pass it to the ResourceReader(Stream) constructor. Para leer de un archivo. Resources incrustado, llame al método Assembly.GetManifestResourceStream con el nombre que distingue entre mayúsculas y minúsculas del archivo. Resources, y pase el objeto Stream devuelto al constructor ResourceReader(Stream).To read from an embedded .resources file, call the Assembly.GetManifestResourceStream method with the case-sensitive name of the .resources file, and pass the returned Stream object to the ResourceReader(Stream) constructor.

Importante

Usar una instancia de este objeto con datos que no son de confianza supone un riesgo de seguridad.Using an instance of this object with untrusted data is a security risk. Utilice este objeto solo con datos de confianza.Use this object only with trusted data. Para obtener más información, vea Data Validation (Validación de datos).For more information, see Data Validation.

Seguridad

SecurityPermission
permite proporcionar servicios de serialización.for providing serialization services. Acción de seguridad: LinkDemand.Security action: LinkDemand. Enumeración asociada: SerializationFormatterAssociated enumeration: SerializationFormatter

SecurityCriticalAttribute
requiere plena confianza para el llamador inmediato.requires full trust for the immediate caller. Este miembro no puede ser utilizado por código transparente o de confianza parcial.This member cannot be used by partially trusted or transparent code.

Consulte también:

ResourceReader(String)

Inicializa una nueva instancia de la clase ResourceReader para el archivo de recursos denominado especificado.Initializes a new instance of the ResourceReader class for the specified named resource file.

public:
 ResourceReader(System::String ^ fileName);
public ResourceReader (string fileName);
new System.Resources.ResourceReader : string -> System.Resources.ResourceReader
Public Sub New (fileName As String)

Parámetros

fileName
String

Ruta de acceso y nombre del archivo de recursos que se van a leer.The path and name of the resource file to read. filename no distingue mayúsculas de minúsculas.filename is not case-sensitive.

Excepciones

El parámetro fileName es null.The fileName parameter is null.

No se puede encontrar el archivo.The file cannot be found.

Error de E/S.An I/O error has occurred.

El archivo de recursos tiene un formato no válido.The resource file has an invalid format. Por ejemplo, la longitud del archivo puede ser cero.For example, the length of the file may be zero.

Ejemplos

En el ejemplo de esta sección se usa el siguiente archivo. txt denominado PatientForm.txt para definir los recursos utilizados por una aplicación.The example in this section uses the following .txt file named PatientForm.txt to define the resources used by an application.

  
Title="Top Pet Animal Clinic"  
Label1="Patient Number:"  
Label2="Pet Name:"  
Label3="Species:"  
Label4="Breed:"  
Label5="Date of Birth:"  
Label6="Age:"  
Label7="Owner:"  
Label8="Address:"  
Label9="Home Phone:"  
Label10="Work Phone:"  
Label11="Mobile Phone:"  
  

Puede compilar este archivo. txt en un archivo. Resources emitiendo el comando siguiente:You can compile this .txt file into a .resources file by issuing the following command:

Resgen PatientForm. txtresgen PatientForm.txt

En el ejemplo siguiente se enumeran los recursos de PatientForm.resources y se muestran el nombre y el valor de cada uno de ellos.The following example enumerates the resources in PatientForm.resources and displays the name and value of each.

using System;
using System.Collections;
using System.Resources;

public class Example
{
   public static void Main()
   {
      var rr = new ResourceReader("PatientForm.resources");
      IDictionaryEnumerator dict = rr.GetEnumerator();
      int ctr = 0;

      while (dict.MoveNext()) {
         ctr++;
         Console.WriteLine("{0:00}: {1} = {2}", ctr, dict.Key, dict.Value);
      }

      rr.Close();
   }
}
// The example displays the following output:
//       01: Label3 = "Species:"
//       02: Label2 = "Pet Name:"
//       03: Label1 = "Patient Number:"
//       04: Label7 = "Owner:"
//       05: Label6 = "Age:"
//       06: Label5 = "Date of Birth:"
//       07: Label4 = "Breed:"
//       08: Label9 = "Home Phone:"
//       09: Label8 = "Address:"
//       10: Title = "Top Pet Animal Clinic"
//       11: Label10 = "Work Phone:"
//       12: Label11 = "Mobile Phone:"
Imports System.Collections
Imports System.Resources

Module Example
   Public Sub Main()
      Dim rr As New ResourceReader("PatientForm.resources")
      Dim dict As IDictionaryEnumerator = rr.GetEnumerator
      Dim ctr As Integer

      Do While dict.MoveNext()
         ctr += 1
         Console.WriteLine("{0:00}: {1} = {2}", ctr, dict.Key, dict.Value)
      Loop
      
      rr.Close()
   End Sub
End Module
' The example displays the following output:
'       01: Label3 = "Species:"
'       02: Label2 = "Pet Name:"
'       03: Label1 = "Patient Number:"
'       04: Label7 = "Owner:"
'       05: Label6 = "Age:"
'       06: Label5 = "Date of Birth:"
'       07: Label4 = "Breed:"
'       08: Label9 = "Home Phone:"
'       09: Label8 = "Address:"
'       10: Title = "Top Pet Animal Clinic"
'       11: Label10 = "Work Phone:"
'       12: Label11 = "Mobile Phone:"

Comentarios

El constructor ResourceReader(String) crea una instancia de un objeto ResourceReader que recupera recursos de un archivo. Resources independiente.The ResourceReader(String) constructor instantiates a ResourceReader object that retrieves resources from a standalone .resources file. Para recuperar recursos de un archivo. Resources incrustado, utilice el constructor de ResourceReader(Stream).To retrieve resources from an embedded .resources file, use the ResourceReader(Stream) constructor.

Importante

Usar una instancia de este objeto con datos que no son de confianza supone un riesgo de seguridad.Using an instance of this object with untrusted data is a security risk. Utilice este objeto solo con datos de confianza.Use this object only with trusted data. Para obtener más información, vea Data Validation (Validación de datos).For more information, see Data Validation.

Se aplica a