ResourceWriter.AddResource Método

Definição

Adiciona um recurso à lista de recursos a escrever.

Sobrecargas

Name Description
AddResource(String, Byte[])

Adiciona um recurso nomeado especificado como um array de bytes à lista de recursos a escrever.

AddResource(String, Stream)

Adiciona um recurso nomeado especificado como fluxo à lista de recursos a escrever.

AddResource(String, Object)

Adiciona um recurso nomeado especificado como objeto à lista de recursos a escrever.

AddResource(String, String)

Adiciona um recurso string à lista de recursos a escrever.

AddResource(String, Stream, Boolean)

Adiciona um recurso nomeado especificado como fluxo à lista de recursos a escrever, e especifica se o fluxo deve ser fechado após o Generate() método ser chamado.

AddResource(String, Byte[])

Adiciona um recurso nomeado especificado como um array de bytes à lista de recursos a escrever.

public:
 virtual void AddResource(System::String ^ name, cli::array <System::Byte> ^ value);
public void AddResource(string name, byte[] value);
abstract member AddResource : string * byte[] -> unit
override this.AddResource : string * byte[] -> unit
Public Sub AddResource (name As String, value As Byte())

Parâmetros

name
String

O nome do recurso.

value
Byte[]

Valor do recurso como um array inteiro não sinalado de 8 bits.

Implementações

Exceções

name (ou um nome que varia apenas por maiúscula) já foi adicionado a este ResourceWriter.

O name parâmetro é null.

Esta ResourceWriter foi encerrada e a sua tabela de hash não está disponível.

Exemplos

O exemplo seguinte utiliza o AddResource(String, Byte[]) método para adicionar uma imagem gráfica que foi lida como um array de bytes a um ResourceWriter objeto.

using System;
using System.IO;
using System.Resources;

public class Example
{
   public static void Main()
   {
      // Get the image as an array of bytes.
      FileStream byteStream = new FileStream("AppIcon.jpg", FileMode.Open);
      Byte[] bytes = new Byte[(int) byteStream.Length];
      byteStream.Read(bytes, 0, (int) byteStream.Length);
      
      // Create the resource file.
      using (ResourceWriter rw = new ResourceWriter(@".\UIImages.resources")) {
         rw.AddResource("AppIcon", byteStream);
         // Add any other resources.
      }
   }
}
Imports System.IO
Imports System.Resources

Module Example
   Public Sub Main()                      
      ' Get the image as an array of bytes.
      Dim byteStream As New FileStream("AppIcon.jpg", Filemode.Open)
      Dim bytes(CInt(byteStream.Length - 1)) As Byte
      byteStream.Read(bytes, 0, CInt(byteStream.Length))
      
      ' Create the resource file.
      Using rw As New ResourceWriter(".\UIImages.resources")
         rw.AddResource("AppIcon", byteStream)
         ' Add any other resources.
      End Using
   End Sub
End Module

Observações

O recurso não é escrito até Generate ser chamado.

Pode recuperar os recursos escritos pelo AddResource(String, Byte[]) método chamando o ResourceManager.GetStream método.

Ver também

Aplica-se a

AddResource(String, Stream)

Adiciona um recurso nomeado especificado como fluxo à lista de recursos a escrever.

public:
 void AddResource(System::String ^ name, System::IO::Stream ^ value);
public void AddResource(string name, System.IO.Stream value);
member this.AddResource : string * System.IO.Stream -> unit
Public Sub AddResource (name As String, value As Stream)

Parâmetros

name
String

O nome do recurso a acrescentar.

value
Stream

O valor do recurso a acrescentar. O recurso deve suportar a Length propriedade.

Exceções

name (ou um nome que varia apenas por maiúscula) já foi adicionado a este ResourceWriter.

-ou-

O riacho não suporta a Length propriedade.

name ou value é null.

Exemplos

O exemplo seguinte utiliza o AddResource(String, Stream) método para adicionar uma imagem gráfica que foi guardada num MemoryStream objeto a um ResourceWriter objeto.

using System;
using System.Drawing;
using System.Drawing.Imaging;
using System.IO;
using System.Resources;

public class Example
{
   public static void Main()
   {
      // Bitmap as stream
      MemoryStream bitmapStream = new MemoryStream();
      Bitmap bmp = new Bitmap(@".\\AppImage.jpg");
      bmp.Save(bitmapStream, ImageFormat.Jpeg);
          
      using (ResourceWriter rw = new ResourceWriter(@".\UIImages.resources"))
      {
         rw.AddResource("Bitmap", bitmapStream);
         // Add other resources.
      }
   }
}
Imports System.Drawing
Imports System.IO
Imports System.Resources

Module Example
   Public Sub Main()
      ' Bitmap as stream
      Dim bitmapStream As New MemoryStream()
      Dim bmp As New Bitmap(".\\AppImage.jpg")
      bmp.Save(bitmapStream, Imaging.ImageFormat.Jpeg)
          
      Using rw As New ResourceWriter(".\UIImages.resources")
         rw.AddResource("Bitmap", bitmapStream)
         ' Add other resources.
      End Using
   End Sub
End Module

Observações

Pode especificar qualquer fluxo que suporte a Stream.Length propriedade para value.

Pode recuperar os recursos escritos pelo AddResource(String, Stream) método chamando o ResourceManager.GetStream método.

Ver também

Aplica-se a

AddResource(String, Object)

Adiciona um recurso nomeado especificado como objeto à lista de recursos a escrever.

public:
 virtual void AddResource(System::String ^ name, System::Object ^ value);
public void AddResource(string name, object value);
abstract member AddResource : string * obj -> unit
override this.AddResource : string * obj -> unit
Public Sub AddResource (name As String, value As Object)

Parâmetros

name
String

O nome do recurso.

value
Object

O valor do recurso.

Implementações

Exceções

name (ou um nome que varia apenas por maiúscula) já foi adicionado a este ResourceWriter.

O name parâmetro é null.

Esta ResourceWriter foi encerrada e a sua tabela de hash não está disponível.

Exemplos

O exemplo seguinte utiliza o AddResource(String, Object) método para adicionar dados de objeto a um ficheiro binário de recursos.

using System;
using System.Resources;

public class Example
{
   public static void Main()
   {
      DonorColumns columns = new DonorColumns("Emplyee #", "Name", 
                                              "Total Amount", "Last Donation Date",
                                              "Last Donation Amount");
      ResourceWriter resFile = new ResourceWriter(@".\UIResources.resources");
      resFile.AddResource("Title", "Corporate Gold Star Donors");
      resFile.AddResource("NColumns", 5);
      resFile.AddResource("AppDate", new DateTime(2011, 5, 28));
      resFile.AddResource("AppVersion", new Version(1, 0, 217));
      resFile.AddResource("HRVersion", true);
      resFile.Generate();
      resFile.Close();               
   }
}

// Class to hold potentially localized column names.
[Serializable] public class DonorColumns
{
   readonly string ID;
   readonly string Name;
   readonly string Total;
   readonly string Last;
   readonly string Amt;

   public DonorColumns(string id, string name, string total, 
                  string last, string amt)
   {                  
      this.ID = id;
      this.Name = name;
      this.Total = total;
      this.Last = last;
      this.Amt = amt;                        
   }   
}

DonorColumns é uma classe personalizada cujos campos contêm os nomes das colunas a serem exibidas na interface do utilizador. Note que a classe está marcada com o SerializableAttribute atributo. Normalmente, a classe seria definida numa assembly separada, e uma referência a ela seria fornecida ao compilador em tempo de compilação.

Observações

value Tem de ser serializável.

O recurso não é escrito até que o Generate método seja chamado.

Pode recuperar os recursos escritos pelo AddResource(String, Object) método chamando o ResourceManager.GetObject método.

Ver também

Aplica-se a

AddResource(String, String)

Adiciona um recurso string à lista de recursos a escrever.

public:
 virtual void AddResource(System::String ^ name, System::String ^ value);
public void AddResource(string name, string value);
abstract member AddResource : string * string -> unit
override this.AddResource : string * string -> unit
Public Sub AddResource (name As String, value As String)

Parâmetros

name
String

O nome do recurso.

value
String

O valor do recurso.

Implementações

Exceções

name (ou um nome que varia apenas por maiúscula) já foi adicionado a este ResourceWriter.

O name parâmetro é null.

Esta ResourceWriter foi encerrada e a sua tabela de hash não está disponível.

Exemplos

O exemplo seguinte utiliza o AddResource método para adicionar recursos de cadeia a um ResourceWriter objeto.

using System;
using System.Resources;
using System.IO;

public class WriteResources 
{
    public static void Main(string[] args) 
    {  
        // Create a file stream to encapsulate items.resources.
        FileStream fs = new FileStream("items.resources", 
        FileMode.OpenOrCreate,FileAccess.Write);

        // Open a resource writer to write from the stream.
        IResourceWriter writer = new ResourceWriter(fs);
    
        // Add resources to the resource writer.
        writer.AddResource("String 1", "First String");
        writer.AddResource("String 2", "Second String");
        writer.AddResource("String 3", "Third String");

        // Write the resources to the stream, and close it.
        writer.Close();
    }
}
Imports System.Resources
Imports System.IO

Public Class WriteResources
   
    Public Shared Sub Main(args() As String)
        ' Create a file stream to encapsulate items.resources.
        Dim fs As New FileStream("items.resources", _
           FileMode.OpenOrCreate, FileAccess.Write)
      
        ' Open a resource writer to write from the stream.
        Dim writer = New ResourceWriter(fs)
      
        ' Add resources to the resource writer.
        writer.AddResource("String 1", "First String")
        writer.AddResource("String 2", "Second String")
        writer.AddResource("String 3", "Third String")
      
        ' Write the resources to the stream, and close it.
        writer.Close()
    End Sub

End Class

Observações

O recurso não é escrito até Generate ser chamado.

Pode recuperar os recursos escritos pelo AddResource(String, String) método chamando o ResourceManager.GetString método.

Ver também

Aplica-se a

AddResource(String, Stream, Boolean)

Adiciona um recurso nomeado especificado como fluxo à lista de recursos a escrever, e especifica se o fluxo deve ser fechado após o Generate() método ser chamado.

public:
 void AddResource(System::String ^ name, System::IO::Stream ^ value, bool closeAfterWrite);
public void AddResource(string name, System.IO.Stream value, bool closeAfterWrite);
member this.AddResource : string * System.IO.Stream * bool -> unit
Public Sub AddResource (name As String, value As Stream, closeAfterWrite As Boolean)

Parâmetros

name
String

O nome do recurso a acrescentar.

value
Stream

O valor do recurso a acrescentar. O recurso deve suportar a Length propriedade.

closeAfterWrite
Boolean

true para fechar o fluxo após o Generate() método ser chamado; caso contrário, false.

Exceções

name (ou um nome que varia apenas por maiúscula) já foi adicionado a este ResourceWriter.

-ou-

O riacho não suporta a Length propriedade.

name ou value é null.

Exemplos

O exemplo seguinte utiliza o AddResource(String, Stream, Boolean) método para adicionar uma imagem gráfica que foi guardada num MemoryStream objeto a um ResourceWriter objeto.

using System;
using System.Drawing;
using System.Drawing.Imaging;
using System.IO;
using System.Resources;

public class Example
{
   public static void Main()
   {
      // Bitmap as stream
      MemoryStream bitmapStream = new MemoryStream();
      Bitmap bmp = new Bitmap(@".\\AppImage.jpg");
      bmp.Save(bitmapStream, ImageFormat.Jpeg);
          
      ResourceWriter rw = new ResourceWriter(@".\UIImages.resources");
      rw.AddResource("Bitmap", bitmapStream, true);
      // Add other resources.
      rw.Generate();
   }
}
Imports System.Drawing
Imports System.IO
Imports System.Resources

Module Example
   Public Sub Main()
      ' Bitmap as stream
      Dim bitmapStream As New MemoryStream()
      Dim bmp As New Bitmap(".\\AppImage.jpg")
      bmp.Save(bitmapStream, Imaging.ImageFormat.Jpeg)
          
      Dim rw As New ResourceWriter(".\UIImages.resources")
      rw.AddResource("Bitmap", bitmapStream, True)
      ' Add other resources.
      rw.Generate()
   End Sub
End Module

Observações

Pode especificar qualquer fluxo que suporte a Stream.Length propriedade para value.

Pode recuperar os recursos escritos pelo AddResource(String, Stream, Boolean) método chamando o ResourceManager.GetStream método.

Ver também

Aplica-se a