ResourceReader Construtores

Definição

Inicializa uma nova instância da ResourceReader classe.

Sobrecargas

Name Description
ResourceReader(Stream)

Inicializa uma nova instância da ResourceReader classe para o fluxo especificado.

ResourceReader(String)

Inicializa uma nova instância da ResourceReader classe para o ficheiro de recurso nomeado especificado.

Observações

Importante

Utilizar uma instância deste tipo com dados não confiáveis é um risco de segurança. Use este objeto apenas com dados confiáveis. Para obter mais informações, consulte Validar todas as informações inseridas.

ResourceReader(Stream)

Inicializa uma nova instância da ResourceReader classe para o fluxo especificado.

public:
 ResourceReader(System::IO::Stream ^ 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
[<System.Security.SecurityCritical>]
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 recursos de leitura.

Atributos

Exceções

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

O stream parâmetro é null.

Ocorreu um erro de E/S ao aceder streama .

Exemplos

O exemplo nesta secção utiliza o seguinte ficheiro de .txt nomeado PatientForm.txt para definir os recursos usados por uma aplicação.

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

Pode compilar o ficheiro .txt num ficheiro .resources emitindo o seguinte comando:

resgen PatientForm.txt

O exemplo seguinte assume que o ficheiro de recurso está incorporado no assembly que contém o código executável da aplicação. Recupera um ficheiro de recurso nomeado PatientForm.resources dos assemblies atualmente em execução e apresenta o nome e o valor de cada um dos 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# se chamar Example.cs, pode compilá-lo usando o seguinte comando:

csc Example.cs /res:PatientForm.resources

Se o exemplo Visual Basic se chamar Example.vb, pode compilar usando o seguinte comando:

vbc Example.vb /res:PatientForm.resources

Observações

O ResourceReader(Stream) construtor instancia um ResourceReader objeto que recupera recursos, seja de um ficheiro .resources autónomo ou de um ficheiro .resources incorporado numa assembly. Para ler a partir de um ficheiro .resources independente, instância um Stream objeto e passa-o para o ResourceReader(Stream) construtor. Para ler a partir de um ficheiro .resources incorporado, chame o Assembly.GetManifestResourceStream método com o nome distinto de maiúsculas minúsculas do ficheiro .resources e passe o objeto devolvido Stream ao ResourceReader(Stream) construtor.

Importante

Utilizar uma instância deste tipo com dados não confiáveis é um risco de segurança. Use este objeto apenas com dados confiáveis. Para obter mais informações, consulte Validar todas as informações inseridas.

Ver também

Aplica-se a

ResourceReader(String)

Inicializa uma nova instância da ResourceReader classe para o ficheiro 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 ficheiro de recurso a ler. filename não diferencia maiúsculas de minúsculas.

Exceções

O fileName parâmetro é null.

O ficheiro não pode ser encontrado.

Ocorreu um erro de E/S.

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

Exemplos

O exemplo nesta secção utiliza o seguinte ficheiro de .txt nomeado PatientForm.txt para definir os recursos usados por uma aplicação.

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

Pode compilar este ficheiro .txt num ficheiro .resources emitindo o seguinte comando:

resgen PatientForm.txt

O exemplo seguinte enumera os recursos presentes PatientForm.resources e mostra o nome e 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:"

Observações

O ResourceReader(String) construtor instancia um ResourceReader objeto que recupera recursos de um ficheiro .resources autónomo. Para recuperar recursos de um ficheiro .resources incorporado, use o ResourceReader(Stream) construtor.

Importante

Utilizar uma instância deste tipo com dados não confiáveis é um risco de segurança. Use este objeto apenas com dados confiáveis. Para obter mais informações, consulte Validar todas as informações inseridas.

Aplica-se a