ResourceReader.GetResourceData(String, String, Byte[]) 方法

定義

命名空間:

System.Resources

組件:

System.Runtime.dll

來源:

ResourceReader.Core.cs

從開啟的資源檔或資料流，擷取具名資源的類型名稱和資料。

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

參數

resourceName

String

資源的名稱。

resourceType

String

這個方法傳回時，包含表示所擷取資源類型名稱的字串。 這個參數會以未初始化的狀態傳遞。

resourceData

Byte[]

當這個方法傳回時，會包含以所擷取類型之二進位表示的位元組陣列。 這個參數會以未初始化的狀態傳遞。

例外狀況

ArgumentNullException

resourceName 為 null。

ArgumentException

resourceName 不存在。

BadImageFormatException

resourceName 具有不正確的型別。

FormatException

擷取的資源資料已損毀。

InvalidOperationException

目前的ResourceReader物件尚未初始化，可能因為它已關閉。

備註

方法 GetResourceData 會將具名資源的值擷取為位元組陣列。 當屬性嘗試擷取資源的值時，通常會使用 Value 此屬性擲回例外狀況。

resourceType 是表示資源數據類型的字串。 可以是下列其中任何一個值：

• 列舉成員的 ResourceTypeCode 字串表示，表示資源的數據類型。 ResourceTypeCode 是 .用來表示特殊二進位格式用來儲存 19 種常見數據類型之一的私人列舉。 這些包括 .NET Framework 基本數據類型 (Boolean、Byte、UInt64DecimalDoubleInt16Int32UInt16CharSByteUInt32Int64SingleString) ，以及 、 DateTime和 TimeSpan，此外，ResourceTypeCode列舉也包含下表所示的值。

  ResourceTypeCode 值	描述
  ResourceTypeCode.ByteArray	數據是位元組陣列。 這個數據類型通常是從呼叫 ResourceWriter.AddResource(String, Byte[]) 方法所產生。
  ResourceTypeCode.Null	數據是 Null 參考。 這個數據類型通常是從呼叫 ResourceWriter.AddResource(String, Object) 方法產生，其值為 null的物件。
  ResourceTypeCode.Stream	數據會儲存在數據流中。 這個數據類型通常是從呼叫 ResourceWriter.AddResource(String, Stream) 或 ResourceWriter.AddResource(String, Stream, Boolean) 方法所產生。

  假設 resourceData 尚未損毀，它通常會藉由呼叫 BitConverter 或 BinaryReader 方法，從位元組陣列轉換回其原始值。

• 字串，包含型別的完整名稱，其串行化數據會指派給 resourceData 自變數 (，例如， System.String) 。 此外，對於不屬於 .NET 類別庫的類型，字串會包含包含型別之元件的名稱、版本、文化特性和公鑰。 例如，下列字串表示串行化數據代表命名空間中類型的實例，該實例 Person 位於名為Utility的元件1.0版中 Extensions ，該元件沒有公鑰且沒有指定的文化特性。

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

• 用來描述方法呼叫中數據類型的 ResourceWriter.AddResourceData 字串。

另請參閱

• AddResourceData(String, String, Byte[])