ResourceWriter.AddResource Metode

Referensi

Definisi

Ruang nama:: System.Resources

Rakitan:: System.Resources.Writer.dll

Rakitan:: mscorlib.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menambahkan sumber daya ke daftar sumber daya yang akan ditulis.

Overload

AddResource(String, Byte[])	Menambahkan sumber daya bernama yang ditentukan sebagai array byte ke daftar sumber daya yang akan ditulis.
AddResource(String, Stream)	Menambahkan sumber daya bernama yang ditentukan sebagai aliran ke daftar sumber daya yang akan ditulis.
AddResource(String, Object)	Menambahkan sumber daya bernama yang ditentukan sebagai objek ke daftar sumber daya yang akan ditulis.
AddResource(String, String)	Menambahkan sumber daya string ke daftar sumber daya yang akan ditulis.
AddResource(String, Stream, Boolean)	Menambahkan sumber daya bernama yang ditentukan sebagai aliran ke daftar sumber daya yang akan ditulis, dan menentukan apakah aliran harus ditutup setelah Generate() metode dipanggil.

AddResource(String, Byte[])

Sumber:: ResourceWriter.cs

Sumber:: ResourceWriter.cs

Sumber:: ResourceWriter.cs

Menambahkan sumber daya bernama yang ditentukan sebagai array byte ke daftar sumber daya yang akan ditulis.

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

Nama sumber daya.

value: Byte[]

Nilai sumber daya sebagai array bilangan bulat yang tidak ditandatangani 8-bit.

Penerapan

AddResource(String, Byte[])

Pengecualian

ArgumentException

name (atau nama yang hanya bervariasi berdasarkan kapitalisasi) telah ditambahkan ke ini ResourceWriter.

ArgumentNullException

Parameternya name adalah null.

InvalidOperationException

Ini ResourceWriter telah ditutup dan tabel hash-nya tidak tersedia.

Contoh

Contoh berikut menggunakan AddResource(String, Byte[]) metode untuk menambahkan gambar grafis yang telah dibaca sebagai array byte ke ResourceWriter objek.

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

Keterangan

Sumber daya tidak ditulis sampai Generate dipanggil.

Anda dapat mengambil sumber daya yang ditulis oleh AddResource(String, Byte[]) metode dengan memanggil ResourceManager.GetStream metode .

Lihat juga

Membuat File Sumber Daya untuk Aplikasi Desktop

Berlaku untuk

AddResource(String, Stream)

Sumber:: ResourceWriter.core.cs

Sumber:: ResourceWriter.core.cs

Sumber:: ResourceWriter.core.cs

Menambahkan sumber daya bernama yang ditentukan sebagai aliran ke daftar sumber daya yang akan ditulis.

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

Nama sumber daya yang akan ditambahkan.

value: Stream

Nilai sumber daya yang akan ditambahkan. Sumber daya harus mendukung Length properti .

Pengecualian

ArgumentException

name (atau nama yang hanya bervariasi berdasarkan kapitalisasi) telah ditambahkan ke ini ResourceWriter.

-atau-

Aliran tidak mendukung Length properti .

ArgumentNullException

name atau value adalah null.

InvalidOperationException

Ini ResourceWriter telah ditutup.

Contoh

Contoh berikut menggunakan AddResource(String, Stream) metode untuk menambahkan gambar grafis yang telah disimpan ke MemoryStream objek ke ResourceWriter objek.

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

Keterangan

Anda dapat menentukan aliran apa pun yang mendukung Stream.Length properti untuk value.

Anda dapat mengambil sumber daya yang ditulis oleh AddResource(String, Stream) metode dengan memanggil ResourceManager.GetStream metode .

Lihat juga

Membuat File Sumber Daya untuk Aplikasi Desktop

Berlaku untuk

AddResource(String, Object)

Sumber:: ResourceWriter.cs

Sumber:: ResourceWriter.cs

Sumber:: ResourceWriter.cs

Menambahkan sumber daya bernama yang ditentukan sebagai objek ke daftar sumber daya yang akan ditulis.

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

Nama sumber daya.

value: Object

Nilai sumber daya.

Penerapan

AddResource(String, Object)

Pengecualian

ArgumentException

name (atau nama yang hanya bervariasi berdasarkan kapitalisasi) telah ditambahkan ke ini ResourceWriter.

ArgumentNullException

Parameternya name adalah null.

InvalidOperationException

Ini ResourceWriter telah ditutup dan tabel hash-nya tidak tersedia.

Contoh

Contoh berikut menggunakan AddResource(String, Object) metode untuk menambahkan data objek ke file sumber daya biner.

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 adalah kelas kustom yang bidangnya berisi nama kolom yang akan ditampilkan di antarmuka pengguna. Perhatikan bahwa kelas ditandai dengan SerializableAttribute atribut . Biasanya, kelas akan didefinisikan dalam rakitan terpisah, dan referensi untuk itu akan diberikan kepada pengkompilasi pada waktu kompilasi.

Keterangan

value harus dapat diserialisasikan.

Sumber daya tidak ditulis sampai metode dipanggil Generate .

Anda dapat mengambil sumber daya yang ditulis oleh AddResource(String, Object) metode dengan memanggil ResourceManager.GetObject metode .

Lihat juga

Membuat File Sumber Daya untuk Aplikasi Desktop

Berlaku untuk

AddResource(String, String)

Sumber:: ResourceWriter.cs

Sumber:: ResourceWriter.cs

Sumber:: ResourceWriter.cs

Menambahkan sumber daya string ke daftar sumber daya yang akan ditulis.

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

Nama sumber daya.

value: String

Nilai sumber daya.

Penerapan

AddResource(String, String)

Pengecualian

ArgumentException

name (atau nama yang hanya bervariasi berdasarkan kapitalisasi) telah ditambahkan ke ResourceWriter ini.

ArgumentNullException

Parameternya name adalah null.

InvalidOperationException

Ini ResourceWriter telah ditutup dan tabel hash-nya tidak tersedia.

Contoh

Contoh berikut menggunakan AddResource metode untuk menambahkan sumber daya string ke ResourceWriter objek.

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

Keterangan

Sumber daya tidak ditulis sampai Generate dipanggil.

Anda dapat mengambil sumber daya yang ditulis oleh AddResource(String, String) metode dengan memanggil ResourceManager.GetString metode .

Lihat juga

Membuat File Sumber Daya untuk Aplikasi Desktop

Berlaku untuk

AddResource(String, Stream, Boolean)

Sumber:: ResourceWriter.cs

Sumber:: ResourceWriter.cs

Sumber:: ResourceWriter.cs

Menambahkan sumber daya bernama yang ditentukan sebagai aliran ke daftar sumber daya yang akan ditulis, dan menentukan apakah aliran harus ditutup setelah Generate() metode dipanggil.

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

Nama sumber daya yang akan ditambahkan.

value: Stream

Nilai sumber daya yang akan ditambahkan. Sumber daya harus mendukung Length properti .

closeAfterWrite: Boolean

true untuk menutup aliran setelah metode dipanggil Generate() ; jika tidak, false.

Pengecualian

ArgumentException

name (atau nama yang hanya bervariasi berdasarkan kapitalisasi) telah ditambahkan ke ini ResourceWriter.

-atau-

Aliran tidak mendukung Length properti .

ArgumentNullException

name atau value adalah null.

InvalidOperationException

Ini ResourceWriter telah ditutup.

Contoh

Contoh berikut menggunakan AddResource(String, Stream, Boolean) metode untuk menambahkan gambar grafis yang telah disimpan ke MemoryStream objek ke ResourceWriter objek.

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

Keterangan

Anda dapat menentukan aliran apa pun yang mendukung Stream.Length properti untuk value.

Anda dapat mengambil sumber daya yang ditulis oleh AddResource(String, Stream, Boolean) metode dengan memanggil ResourceManager.GetStream metode .

Lihat juga

Membuat File Sumber Daya untuk Aplikasi Desktop

Berlaku untuk

Bagikan melalui

ResourceWriter.AddResource Metode

Definisi

Overload

AddResource(String, Byte[])

Parameter

Penerapan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

AddResource(String, Stream)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

AddResource(String, Object)

Parameter

Penerapan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

AddResource(String, String)

Parameter

Penerapan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

AddResource(String, Stream, Boolean)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Saran dan Komentar

Sumber Daya Tambahan: