ResourceReader Construtores

Definição

Namespace:

System.Resources

Assembly:

System.Runtime.dll

Inicializa uma nova instância da classe ResourceReader.

Sobrecargas

ResourceReader(Stream)	Inicializa uma nova instância da classe ResourceReader para o fluxo especificado.
ResourceReader(String)	Inicializa uma nova instância da classe ResourceReader para o arquivo de recurso nomeado especificado.

Comentários

> [! IMPORTANTE] > O uso de uma instância desse objeto com dados não confiáveis é um risco à segurança. Use esse objeto somente quando você tiver dados confiáveis. Para obter mais informações, consulte Validar todas as entradas..

ResourceReader(Stream)

Origem:

ResourceReader.cs

Inicializa uma nova instância da classe ResourceReader para o fluxo 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

O fluxo de entrada para a leitura de recursos.

Exceções

ArgumentException

O parâmetro stream não é legível.

ArgumentNullException

O parâmetro stream é null.

IOException

Erro de E/S ao acessar stream.

Exemplos

O exemplo nesta seção usa o seguinte arquivo .txt chamado PatientForm.txt para definir os recursos usados por um aplicativo.

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:"

Você pode compilar o arquivo .txt em um arquivo .resources emitindo o seguinte comando:

resgen PatientForm.txt

O exemplo a seguir pressupõe que o arquivo de recurso esteja inserido no assembly que contém o código executável do aplicativo. Ele recupera um arquivo de recurso chamado PatientForm.resources dos assemblies em execução no momento e exibe o nome e o valor de cada um de seus 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:"

Se o exemplo de C# for chamado Example.cs, você poderá compilá-lo usando o seguinte comando:

csc Example.cs /res:PatientForm.resources

Se o exemplo do Visual Basic for chamado Example.vb, você poderá compilá-lo usando o seguinte comando:

vbc Example.vb /res:PatientForm.resources

Comentários

O ResourceReader(Stream) construtor cria uma instância de um ResourceReader objeto que recupera recursos de um arquivo .resources autônomo ou de um arquivo .resources inserido em um assembly. Para ler de um arquivo .resources autônomo, instancie um Stream objeto e passe-o para o ResourceReader(Stream) construtor. Para ler de um arquivo .resources inserido, chame o Assembly.GetManifestResourceStream método com o nome que diferencia maiúsculas de minúsculas do arquivo .resources e passe o objeto retornado Stream para o ResourceReader(Stream) construtor.

Importante

Usar uma instância deste objeto quando você tiver dados não confiáveis é um risco à segurança. Use esse objeto somente quando você tiver dados confiáveis. Para obter mais informações, consulte Validar todas as entradas.

Confira também

• GetManifestResourceStream(String)

ResourceReader(String)

Origem:

ResourceReader.cs

Inicializa uma nova instância da classe ResourceReader para o arquivo de recurso nomeado 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

O caminho e o nome do arquivo de recurso a ser lido. filename não diferencia maiúsculas de minúsculas.

Exceções

ArgumentNullException

O parâmetro fileName é null.

FileNotFoundException

Não é possível encontrar o arquivo.

IOException

Ocorreu um erro de E/S.

BadImageFormatException

O arquivo de recurso tem um formato inválido. Por exemplo, o tamanho do arquivo pode ser zero.

Exemplos

O exemplo nesta seção usa o seguinte arquivo .txt chamado PatientForm.txt para definir os recursos usados por um aplicativo.

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:"

Você pode compilar esse arquivo .txt em um arquivo .resources emitindo o seguinte comando:

resgen PatientForm.txt

O exemplo a seguir enumera os recursos em PatientForm.resources e exibe o nome e o valor de cada um.

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:"

Comentários

O ResourceReader(String) construtor cria uma instância de um ResourceReader objeto que recupera recursos de um arquivo .resources autônomo. Para recuperar recursos de um arquivo .resources inserido, use o ResourceReader(Stream) construtor .

Importante

Usar uma instância deste objeto quando você tiver dados não confiáveis é um risco à segurança. Use esse objeto somente quando você tiver dados confiáveis. Para obter mais informações, consulte Validar todas as entradas.