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 、 Int16DoubleDecimalInt32Int64SingleUInt16UInt64SByteCharUInt32) String 以及 、 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 類別庫的類型，字串會包含包含類型之元件的名稱、版本、文化特性和公開金鑰。 例如，下列字串表示序列化資料代表命名空間中 Extensions 型別的 Person 實例，該實例位於名為 Utility 的元件 1.0 版中，該元件沒有公開金鑰且沒有指定的文化特性。

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

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

另請參閱

• AddResourceData(String, String, Byte[])