ResourceReader.GetResourceData(String, String, Byte[]) Metode

Definisi

Ruang nama:

System.Resources

Rakitan:

System.Runtime.dll

Sumber:

ResourceReader.Core.cs

Mengambil nama jenis dan data sumber daya bernama dari file atau aliran sumber daya terbuka.

public:
 void GetResourceData(System::String ^ resourceName, [Runtime::InteropServices::Out] System::String ^ % resourceType, [Runtime::InteropServices::Out] cli::array <System::Byte> ^ % resourceData);

public void GetResourceData (string resourceName, out string resourceType, out byte[] resourceData);

member this.GetResourceData : string * string * Byte[] -> unit

Public Sub GetResourceData (resourceName As String, ByRef resourceType As String, ByRef resourceData As Byte())

Parameter

resourceName

String

Nama sumber daya.

resourceType

String

Ketika metode ini kembali, berisi string yang mewakili nama jenis sumber daya yang diambil. Parameter ini diteruskan tanpa diinisialisasi.

resourceData

Byte[]

Ketika metode ini kembali, berisi array byte yang merupakan representasi biner dari jenis yang diambil. Parameter ini diteruskan tanpa diinisialisasi.

Pengecualian

ArgumentNullException

resourceNameadalah null.

ArgumentException

resourceName tidak ada.

BadImageFormatException

resourceName memiliki tipe yang tidak valid.

FormatException

Data sumber daya yang diambil rusak.

InvalidOperationException

Objek saat ini ResourceReader tidak diinisialisasi, mungkin karena ditutup.

Keterangan

Metode ini GetResourceData mengambil nilai sumber daya bernama sebagai array byte. Biasanya digunakan ketika Value properti melemparkan pengecualian ketika mencoba mengambil nilai sumber daya.

resourceType adalah string yang mewakili jenis data sumber daya. Ini bisa menjadi salah satu nilai berikut:

• Representasi string anggota ResourceTypeCode enumerasi yang menunjukkan jenis data sumber daya. ResourceTypeCode adalah enumerasi privat yang digunakan oleh .untuk menunjukkan bahwa format biner khusus digunakan untuk menyimpan salah satu dari 19 jenis data umum. Ini termasuk jenis data primitif .NET Framework (, , , , CharDecimalInt16DoubleInt32, , SByteSingleUInt32UInt16Int64, UInt64), serta String, , DateTimedan TimeSpan, Selain itu, ResourceTypeCode enumerasi menyertakan nilai yang ditunjukkan dalam tabel berikut. ByteBoolean

  Nilai ResourceTypeCode	Deskripsi
  ResourceTypeCode.ByteArray	Data adalah array byte. Jenis data ini biasanya dihasilkan dari panggilan ke ResourceWriter.AddResource(String, Byte[]) metode .
  ResourceTypeCode.Null	Data adalah referensi null. Jenis data ini biasanya dihasilkan dari panggilan ke ResourceWriter.AddResource(String, Object) metode dengan objek yang nilainya adalah null.
  ResourceTypeCode.Stream	Data disimpan dalam aliran. Jenis data ini biasanya dihasilkan dari panggilan ke ResourceWriter.AddResource(String, Stream) metode atau ResourceWriter.AddResource(String, Stream, Boolean) .

  Dengan asumsi bahwa resourceData belum rusak, biasanya dapat dikonversi dari array byte kembali ke nilai aslinya dengan memanggil BitConverter metode atau BinaryReader .

• String yang berisi nama yang sepenuhnya memenuhi syarat dari jenis yang data serialnya ditetapkan ke resourceData argumen (misalnya, System.String). Selain itu, untuk jenis yang bukan bagian dari pustaka kelas .NET, string menyertakan nama, versi, budaya, dan kunci publik perakitan yang berisi jenis . Misalnya, string berikut menunjukkan bahwa data berseri mewakili instans jenis Person di Extensions namespace layanan, yang ditemukan di versi 1.0 dari rakitan bernama Utilitas yang tidak memiliki kunci publik dan tidak ada budaya yang ditunjuk.

  Extensions.Person, Utility, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null

• String yang digunakan untuk menjelaskan jenis data dalam ResourceWriter.AddResourceData panggilan metode.

Lihat juga

• AddResourceData(String, String, Byte[])