Afficher en anglais

Partage via


ResourceWriter.AddResource Méthode

Définition

Ajoute une ressource à la liste de ressources à écrire.

Surcharges

AddResource(String, Byte[])

Ajoute une ressource nommée, spécifiée en tant que tableau d'octets, à la liste des ressources à écrire.

AddResource(String, Stream)

Ajoute une ressource nommée, spécifiée en tant que flux, à la liste des ressources à écrire.

AddResource(String, Object)

Ajoute une ressource nommée, spécifiée en tant qu'objet, à la liste des ressources à écrire.

AddResource(String, String)

Ajoute une ressource de chaîne à la liste de ressources à écrire.

AddResource(String, Stream, Boolean)

Ajoute une ressource nommée, spécifiée en tant que flux, à la liste des ressources à écrire et spécifie si le flux doit être fermé après l'appel de la méthode Generate().

AddResource(String, Byte[])

Source:
ResourceWriter.cs
Source:
ResourceWriter.cs
Source:
ResourceWriter.cs

Ajoute une ressource nommée, spécifiée en tant que tableau d'octets, à la liste des ressources à écrire.

public:
 virtual void AddResource(System::String ^ name, cli::array <System::Byte> ^ value);
public void AddResource (string name, 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())

Paramètres

name
String

Nom de la ressource.

value
Byte[]

Valeur de la ressource en tant que tableau d'entiers non signés 8 bits.

Implémente

Exceptions

name (ou un nom dont seule la casse diffère) a déjà été ajouté à ce ResourceWriter.

Le paramètre name a la valeur null.

ResourceWriter a été fermé et sa table de hachage n'est pas disponible.

Exemples

L’exemple suivant utilise la AddResource(String, Byte[]) méthode pour ajouter une image graphique qui a été lue en tant que tableau d’octets à un ResourceWriter objet.

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

Remarques

La ressource n’est pas écrite tant qu’elle n’est Generate pas appelée.

Vous pouvez récupérer les ressources écrites par la AddResource(String, Byte[]) méthode en appelant la ResourceManager.GetStream méthode .

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

AddResource(String, Stream)

Source:
ResourceWriter.core.cs
Source:
ResourceWriter.core.cs
Source:
ResourceWriter.core.cs

Ajoute une ressource nommée, spécifiée en tant que flux, à la liste des ressources à écrire.

public:
 void AddResource(System::String ^ name, System::IO::Stream ^ value);
public void AddResource (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)

Paramètres

name
String

Nom de la ressource à ajouter.

value
Stream

La valeur de la ressource à ajouter. La ressource doit prendre en charge la propriété Length.

Exceptions

name (ou un nom dont seule la casse diffère) a déjà été ajouté à ce ResourceWriter.

- ou -

Le flux ne prend pas en charge la propriété Length.

name ou value est null.

Exemples

L’exemple suivant utilise la AddResource(String, Stream) méthode pour ajouter une image graphique qui a été enregistrée dans un MemoryStream objet à un ResourceWriter objet .

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

Remarques

Vous pouvez spécifier n’importe quel flux qui prend en charge la Stream.Length propriété pour value.

Vous pouvez récupérer les ressources écrites par la AddResource(String, Stream) méthode en appelant la ResourceManager.GetStream méthode .

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

AddResource(String, Object)

Source:
ResourceWriter.cs
Source:
ResourceWriter.cs
Source:
ResourceWriter.cs

Ajoute une ressource nommée, spécifiée en tant qu'objet, à la liste des ressources à écrire.

public:
 virtual void AddResource(System::String ^ name, System::Object ^ value);
public void AddResource (string name, 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)

Paramètres

name
String

Nom de la ressource.

value
Object

Valeur de la ressource.

Implémente

Exceptions

name (ou un nom dont seule la casse diffère) a déjà été ajouté à ce ResourceWriter.

Le paramètre name a la valeur null.

ResourceWriter a été fermé et sa table de hachage n'est pas disponible.

Exemples

L’exemple suivant utilise la AddResource(String, Object) méthode pour ajouter des données d’objet à un fichier de ressources binaires.

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 est une classe personnalisée dont les champs contiennent les noms des colonnes à afficher dans l’interface utilisateur. Notez que la classe est marquée avec l’attribut SerializableAttribute . En règle générale, la classe est définie dans un assembly distinct et une référence à celle-ci est fournie au compilateur au moment de la compilation.

Remarques

value doit être sérialisable.

La ressource n’est pas écrite tant que la Generate méthode n’est pas appelée.

Vous pouvez récupérer les ressources écrites par la AddResource(String, Object) méthode en appelant la ResourceManager.GetObject méthode .

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

AddResource(String, String)

Source:
ResourceWriter.cs
Source:
ResourceWriter.cs
Source:
ResourceWriter.cs

Ajoute une ressource de chaîne à la liste de ressources à écrire.

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

Paramètres

name
String

Nom de la ressource.

value
String

Valeur de la ressource.

Implémente

Exceptions

name (ou un nom dont seule la casse diffère) a déjà été ajouté à ce ResourceWriter.

Le paramètre name a la valeur null.

ResourceWriter a été fermé et sa table de hachage n'est pas disponible.

Exemples

L’exemple suivant utilise la AddResource méthode pour ajouter des ressources de chaîne à un ResourceWriter objet .

using namespace System;
using namespace System::Resources;
using namespace System::IO;
int main()
{
   
   // Create a file stream to encapsulate items.resources.
   FileStream^ fs = gcnew FileStream( "items.resources",FileMode::OpenOrCreate,FileAccess::Write );
   
   // Open a resource writer to write from the stream.
   IResourceWriter^ writer = gcnew 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();
}
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

Remarques

La ressource n’est pas écrite tant qu’elle n’est Generate pas appelée.

Vous pouvez récupérer les ressources écrites par la AddResource(String, String) méthode en appelant la ResourceManager.GetString méthode .

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

AddResource(String, Stream, Boolean)

Source:
ResourceWriter.cs
Source:
ResourceWriter.cs
Source:
ResourceWriter.cs

Ajoute une ressource nommée, spécifiée en tant que flux, à la liste des ressources à écrire et spécifie si le flux doit être fermé après l'appel de la méthode Generate().

public:
 void AddResource(System::String ^ name, System::IO::Stream ^ value, bool closeAfterWrite);
public void AddResource (string name, System.IO.Stream? value, bool closeAfterWrite = false);
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, Optional closeAfterWrite As Boolean = false)
Public Sub AddResource (name As String, value As Stream, closeAfterWrite As Boolean)

Paramètres

name
String

Nom de la ressource à ajouter.

value
Stream

La valeur de la ressource à ajouter. La ressource doit prendre en charge la propriété Length.

closeAfterWrite
Boolean

true pour fermer le flux après l'appel de la méthode Generate() ; sinon false.

Exceptions

name (ou un nom dont seule la casse diffère) a déjà été ajouté à ce ResourceWriter.

- ou -

Le flux ne prend pas en charge la propriété Length.

name ou value est null.

Exemples

L’exemple suivant utilise la AddResource(String, Stream, Boolean) méthode pour ajouter une image graphique qui a été enregistrée dans un MemoryStream objet à un ResourceWriter objet .

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

Remarques

Vous pouvez spécifier n’importe quel flux qui prend en charge la Stream.Length propriété pour value.

Vous pouvez récupérer les ressources écrites par la AddResource(String, Stream, Boolean) méthode en appelant la ResourceManager.GetStream méthode .

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1