ResourceReader Constructores

Definición

Espacio de nombres:

System.Resources

Ensamblado:

System.Runtime.dll

Inicializa una nueva instancia de la clase ResourceReader.

Sobrecargas

ResourceReader(Stream)	Inicializa una nueva instancia de la clase ResourceReader para el flujo especificado.
ResourceReader(String)	Inicializa una nueva instancia de la clase ResourceReader para el archivo de recursos con nombre especificado.

Comentarios

> [! IMPORTANTE] > El uso de una instancia de este objeto con datos que no son de confianza es un riesgo de seguridad. Utilice este objeto solo con datos de confianza. Para obtener más información, vea Validar todas las entradas.

ResourceReader(Stream)

Source:

ResourceReader.cs

Inicializa una nueva instancia de la clase ResourceReader para el flujo especificado.

public:
 ResourceReader(System::IO::Stream ^ stream);

public ResourceReader (System.IO.Stream stream);

new System.Resources.ResourceReader : System.IO.Stream -> System.Resources.ResourceReader

Public Sub New (stream As Stream)

Parámetros

stream

Stream

Flujo de entrada para la lectura de recursos.

Excepciones

ArgumentException

El parámetro stream no se puede leer.

ArgumentNullException

El parámetro stream es null.

IOException

Error de E/S durante el acceso al parámetro stream.

Ejemplos

En el ejemplo de esta sección se usa el siguiente archivo .txt denominado PatientForm.txt para definir los recursos usados por una aplicación.

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 mediante la emisión del siguiente comando:

resgen PatientForm.txt

En el ejemplo siguiente se supone que el archivo de recursos está incrustado en el ensamblado que contiene el código ejecutable de la aplicación. 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.

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 ejemplo de C# se denomina Example.cs, puede compilarlo mediante el siguiente comando:

csc Example.cs /res:PatientForm.resources

Si el ejemplo de Visual Basic se denomina Example.vb, puede compilarlo mediante el siguiente comando:

vbc Example.vb /res:PatientForm.resources

Comentarios

El ResourceReader(Stream) constructor crea una instancia de un ResourceReader objeto que recupera recursos de un archivo .resources independiente o de un archivo .resources incrustado en un ensamblado. Para leer desde un archivo .resources independiente, cree una instancia de un Stream objeto y páselo al ResourceReader(Stream) constructor. Para leer desde un archivo .resources incrustado, llame al Assembly.GetManifestResourceStream método con el nombre que distingue mayúsculas de minúsculas del archivo .resources y pase el objeto devuelto Stream al ResourceReader(Stream) constructor.

Importante

Usar una instancia de este objeto con datos que no son de confianza supone un riesgo de seguridad. Utilice este objeto solo con datos de confianza. Para obtener más información, vea Validar todas las entradas.

Consulte también

• GetManifestResourceStream(String)

ResourceReader(String)

Source:

ResourceReader.cs

Inicializa una nueva instancia de la clase ResourceReader para el archivo de recursos con nombre especificado.

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. filename no distingue entre mayúsculas y minúsculas.

Excepciones

ArgumentNullException

El parámetro fileName es null.

FileNotFoundException

No se encuentra el archivo.

IOException

Error de E/S.

BadImageFormatException

El archivo de recursos tiene un formato no válido. Por ejemplo, la longitud del archivo puede ser cero.

Ejemplos

En el ejemplo de esta sección se usa el siguiente archivo .txt denominado PatientForm.txt para definir los recursos usados por una aplicación.

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 mediante la emisión del siguiente comando:

resgen PatientForm.txt

En el ejemplo siguiente se enumeran los recursos de PatientForm.resources y se muestra el nombre y el valor de cada uno.

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 ResourceReader(String) constructor crea una instancia de un ResourceReader objeto que recupera recursos de un archivo .resources independiente. Para recuperar recursos de un archivo .resources incrustado, use el ResourceReader(Stream) constructor .

Importante

Usar una instancia de este objeto con datos que no son de confianza supone un riesgo de seguridad. Utilice este objeto solo con datos de confianza. Para obtener más información, vea Validar todas las entradas.