共用方式為


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

定義

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

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[]

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

例外狀況

resourceNamenull

resourceName 不存在。

resourceName 具有不正確的型別。

擷取的資源資料已損毀。

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

備註

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

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

  • 列舉成員的 ResourceTypeCode 字串表示,表示資源的數據類型。 ResourceTypeCode 是 .用來表示特殊二進位格式用來儲存 19 種常見數據類型之一的私人列舉。 這些包括 .NET Framework 基本數據類型 (BooleanByteUInt64DecimalDoubleInt16Int32UInt16CharSByteUInt32Int64SingleString) ,以及 、 DateTimeTimeSpan,此外,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 尚未損毀,它通常會藉由呼叫 BitConverterBinaryReader 方法,從位元組陣列轉換回其原始值。

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

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

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

適用於

另請參閱