ResourceWriter.AddResource Methode

Definition

Namespace:: System.Resources

Assemblys:: netstandard.dll, System.Resources.Writer.dll

Assembly:: System.Resources.Writer.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fügt der Liste der zu schreibenden Ressourcen eine Ressource hinzu.

Überlädt

Name	Beschreibung
AddResource(String, Byte[])	Fügt der Liste der zu schreibenden Ressourcen eine benannte Ressource als Bytearray hinzu.
AddResource(String, Stream)	Fügt der Liste der zu schreibenden Ressourcen eine benannte Ressource als Datenstrom hinzu.
AddResource(String, Object)	Fügt der Liste der zu schreibenden Ressourcen eine benannte Ressource hinzu, die als Objekt angegeben wird.
AddResource(String, String)	Fügt der Liste der zu schreibenden Ressourcen eine Zeichenfolgenressource hinzu.
AddResource(String, Stream, Boolean)	Fügt der Liste der zu schreibenden Ressourcen eine benannte Ressource hinzu, die als Datenstrom angegeben ist, und gibt an, ob der Datenstrom nach dem Aufrufen der Generate() Methode geschlossen werden soll.

AddResource(String, Byte[])

Quelle:: ResourceWriter.cs

Quelle:: ResourceWriter.cs

Quelle:: ResourceWriter.cs

Quelle:: ResourceWriter.cs

Quelle:: ResourceWriter.cs

Fügt der Liste der zu schreibenden Ressourcen eine benannte Ressource als Bytearray hinzu.

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())

Parameter

name: String

Der Name der Ressource.

value: Byte[]

Wert der Ressource als 8-Bit-Ganzzahlarray ohne Vorzeichen.

Implementiert

AddResource(String, Byte[])

Ausnahmen

ArgumentException

name (oder ein Name, der nur nach Groß-/Kleinschreibung variiert) wurde diesem bereits hinzugefügt ResourceWriter.

ArgumentNullException

Der name Parameter ist null.

InvalidOperationException

Dies ResourceWriter wurde geschlossen, und die Hashtabelle ist nicht verfügbar.

Beispiele

Im folgenden Beispiel wird die AddResource(String, Byte[]) Methode verwendet, um ein Grafikbild hinzuzufügen, das als Bytearray zu einem ResourceWriter Objekt gelesen wurde.

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

Hinweise

Die Ressource wird erst geschrieben, wenn Generate sie aufgerufen wird.

Sie können die von der AddResource(String, Byte[]) Methode geschriebenen Ressourcen abrufen, indem Sie die ResourceManager.GetStream Methode aufrufen.

Weitere Informationen

Erstellen von Ressourcendateien für Desktop-Apps

Gilt für:

AddResource(String, Stream)

Quelle:: ResourceWriter.core.cs

Quelle:: ResourceWriter.core.cs

Quelle:: ResourceWriter.core.cs

Quelle:: ResourceWriter.core.cs

Quelle:: ResourceWriter.core.cs

Fügt der Liste der zu schreibenden Ressourcen eine benannte Ressource als Datenstrom hinzu.

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)

Parameter

name: String

Der Name der hinzuzufügenden Ressource.

value: Stream

Der Wert der hinzuzufügenden Ressource. Die Ressource muss die Length Eigenschaft unterstützen.

Ausnahmen

ArgumentException

name (oder ein Name, der nur nach Groß-/Kleinschreibung variiert) wurde diesem bereits hinzugefügt ResourceWriter.

- oder -

Der Datenstrom unterstützt die Length Eigenschaft nicht.

ArgumentNullException

name oder value ist null.

InvalidOperationException

Dies ResourceWriter wurde geschlossen.

Beispiele

Im folgenden Beispiel wird die AddResource(String, Stream) Methode verwendet, um ein Grafikbild hinzuzufügen, das in einem MemoryStream ResourceWriter Objekt gespeichert wurde.

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

Hinweise

Sie können einen beliebigen Datenstrom angeben, der die Stream.Length Eigenschaft valueunterstützt.

Sie können die von der AddResource(String, Stream) Methode geschriebenen Ressourcen abrufen, indem Sie die ResourceManager.GetStream Methode aufrufen.

Weitere Informationen

Erstellen von Ressourcendateien für Desktop-Apps

Gilt für:

AddResource(String, Object)

Quelle:: ResourceWriter.cs

Quelle:: ResourceWriter.cs

Quelle:: ResourceWriter.cs

Quelle:: ResourceWriter.cs

Quelle:: ResourceWriter.cs

Fügt der Liste der zu schreibenden Ressourcen eine benannte Ressource hinzu, die als Objekt angegeben wird.

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)

Parameter

name: String

Der Name der Ressource.

value: Object

Der Wert der Ressource.

Implementiert

AddResource(String, Object)

Ausnahmen

ArgumentException

name (oder ein Name, der nur nach Groß-/Kleinschreibung variiert) wurde diesem bereits hinzugefügt ResourceWriter.

ArgumentNullException

Der name Parameter ist null.

InvalidOperationException

Dies ResourceWriter wurde geschlossen, und die Hashtabelle ist nicht verfügbar.

Beispiele

Im folgenden Beispiel wird die AddResource(String, Object) Methode zum Hinzufügen von Objektdaten zu einer Binärressourcendatei verwendet.

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 ist eine benutzerdefinierte Klasse, deren Felder die Namen von Spalten enthalten, die auf der Benutzeroberfläche angezeigt werden sollen. Beachten Sie, dass die Klasse mit dem SerializableAttribute Attribut gekennzeichnet ist. Ordinarily, the class would be defined in a separate assembly, and a reference to it would be provided to the compiler at compile time.

Hinweise

value muss serialisierbar sein.

Die Ressource wird erst geschrieben, wenn die Generate Methode aufgerufen wird.

Sie können die von der AddResource(String, Object) Methode geschriebenen Ressourcen abrufen, indem Sie die ResourceManager.GetObject Methode aufrufen.

Weitere Informationen

Erstellen von Ressourcendateien für Desktop-Apps

Gilt für:

AddResource(String, String)

Quelle:: ResourceWriter.cs

Quelle:: ResourceWriter.cs

Quelle:: ResourceWriter.cs

Quelle:: ResourceWriter.cs

Quelle:: ResourceWriter.cs

Fügt der Liste der zu schreibenden Ressourcen eine Zeichenfolgenressource hinzu.

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)

Parameter

name: String

Der Name der Ressource.

value: String

Der Wert der Ressource.

Implementiert

AddResource(String, String)

Ausnahmen

ArgumentException

name (oder ein Name, der nur nach Groß-/Kleinschreibung variiert) wurde diesem ResourceWriter bereits hinzugefügt.

ArgumentNullException

Der name Parameter ist null.

InvalidOperationException

Dies ResourceWriter wurde geschlossen, und die Hashtabelle ist nicht verfügbar.

Beispiele

Im folgenden Beispiel wird die AddResource Methode verwendet, um einem ResourceWriter Objekt Zeichenfolgenressourcen hinzuzufügen.

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

Hinweise

Die Ressource wird erst geschrieben, wenn Generate sie aufgerufen wird.

Sie können die von der AddResource(String, String) Methode geschriebenen Ressourcen abrufen, indem Sie die ResourceManager.GetString Methode aufrufen.

Weitere Informationen

Erstellen von Ressourcendateien für Desktop-Apps

Gilt für:

AddResource(String, Stream, Boolean)

Quelle:: ResourceWriter.cs

Quelle:: ResourceWriter.cs

Quelle:: ResourceWriter.cs

Quelle:: ResourceWriter.cs

Quelle:: ResourceWriter.cs

Fügt der Liste der zu schreibenden Ressourcen eine benannte Ressource hinzu, die als Datenstrom angegeben ist, und gibt an, ob der Datenstrom nach dem Aufrufen der Generate() Methode geschlossen werden soll.

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)

Parameter

name: String

Der Name der hinzuzufügenden Ressource.

value: Stream

Der Wert der hinzuzufügenden Ressource. Die Ressource muss die Length Eigenschaft unterstützen.

closeAfterWrite: Boolean

true um den Datenstrom nach dem Aufruf der Generate() Methode zu schließen; andernfalls false.

Ausnahmen

ArgumentException

name (oder ein Name, der nur nach Groß-/Kleinschreibung variiert) wurde diesem bereits hinzugefügt ResourceWriter.

- oder -

Der Datenstrom unterstützt die Length Eigenschaft nicht.

ArgumentNullException

name oder value ist null.

InvalidOperationException

Dies ResourceWriter wurde geschlossen.

Beispiele

Im folgenden Beispiel wird die AddResource(String, Stream, Boolean) Methode verwendet, um ein Grafikbild hinzuzufügen, das in einem MemoryStream ResourceWriter Objekt gespeichert wurde.

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

Hinweise

Sie können einen beliebigen Datenstrom angeben, der die Stream.Length Eigenschaft valueunterstützt.

Sie können die von der AddResource(String, Stream, Boolean) Methode geschriebenen Ressourcen abrufen, indem Sie die ResourceManager.GetStream Methode aufrufen.

Weitere Informationen

Erstellen von Ressourcendateien für Desktop-Apps

Gilt für:

Feedback

War diese Seite hilfreich?

Freigeben über

ResourceWriter.AddResource Methode

Definition

Überlädt

AddResource(String, Byte[])

Parameter

Implementiert

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

AddResource(String, Stream)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

AddResource(String, Object)

Parameter

Implementiert

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

AddResource(String, String)

Parameter

Implementiert

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

AddResource(String, Stream, Boolean)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Feedback