ResourceManager 建構函式

定義

命名空間:

System.Resources

組件:

System.Runtime.dll

初始化 ResourceManager 類別的新執行個體。

多載

ResourceManager()	使用預設值，初始化 ResourceManager 類別的新執行個體。
ResourceManager(Type)	根據指定之型別物件的資訊，初始化可查閱附屬組件中資源之 ResourceManager 類別的新執行個體。
ResourceManager(String, Assembly)	初始化 ResourceManager 類別的新執行個體，這個執行個體會在所指的組件中查閱具有指定根名稱之檔案中的資源。
ResourceManager(String, Assembly, Type)	初始化 ResourceManager 類別的新執行個體，這個執行個體使用指定的 ResourceSet 類別查閱所指組件中具有指定根名稱的檔案所包含的資源。

ResourceManager()

來源:

ResourceManager.cs

使用預設值，初始化 ResourceManager 類別的新執行個體。

protected:
 ResourceManager();

protected ResourceManager ();

Protected Sub New ()

備註

只有當您撰寫衍生自 ResourceManager 類別的類別時，此建構函式才有用。

ResourceManager(Type)

來源:

ResourceManager.cs

根據指定之型別物件的資訊，初始化可查閱附屬組件中資源之 ResourceManager 類別的新執行個體。

public:
 ResourceManager(Type ^ resourceSource);

public ResourceManager (Type resourceSource);

new System.Resources.ResourceManager : Type -> System.Resources.ResourceManager

Public Sub New (resourceSource As Type)

參數

resourceSource

Type

資源管理員從中衍生尋找 .resources 檔所需所有資訊的型別。

例外狀況

ArgumentNullException

resourceSource 參數為 null。

備註

如需此 API 的詳細資訊，請參閱 ResourceManager 建構函式的補充 API 備註。

ResourceManager(String, Assembly)

來源:

ResourceManager.cs

初始化 ResourceManager 類別的新執行個體，這個執行個體會在所指的組件中查閱具有指定根名稱之檔案中的資源。

public:
 ResourceManager(System::String ^ baseName, System::Reflection::Assembly ^ assembly);

public ResourceManager (string baseName, System.Reflection.Assembly assembly);

new System.Resources.ResourceManager : string * System.Reflection.Assembly -> System.Resources.ResourceManager

Public Sub New (baseName As String, assembly As Assembly)

參數

baseName

String

資源檔的根名稱，不含副檔名但包括任何完整的命名空間。 例如，名為 MyApplication.MyResource.en-US.resources 的資源檔根目錄名稱是 MyApplication.MyResource。

assembly

Assembly

資源的主要組件。

例外狀況

ArgumentNullException

baseName 或 assembly 參數為 null。

備註

如需此 API 的詳細資訊，請參閱 ResourceManager 建構函式的補充 API 備註。

給繼承者的注意事項

此建構函式會使用系統提供的 ResourceSet 實作。 若要使用自定義資源檔案格式，您應該衍生自 ResourceSet 類別、覆寫 GetDefaultReader() 和 GetDefaultWriter() 方法，並將該類型傳遞至建 ResourceManager(String, Assembly, Type) 構函式。 使用自定義 ResourceSet 對於控制資源快取原則或支援您自己的資源檔格式很有用，但通常不需要。

ResourceManager(String, Assembly, Type)

來源:

ResourceManager.cs

初始化 ResourceManager 類別的新執行個體，這個執行個體使用指定的 ResourceSet 類別查閱所指組件中具有指定根名稱的檔案所包含的資源。

public:
 ResourceManager(System::String ^ baseName, System::Reflection::Assembly ^ assembly, Type ^ usingResourceSet);

public ResourceManager (string baseName, System.Reflection.Assembly assembly, Type? usingResourceSet);

new System.Resources.ResourceManager : string * System.Reflection.Assembly * Type -> System.Resources.ResourceManager

Public Sub New (baseName As String, assembly As Assembly, usingResourceSet As Type)

參數

baseName

String

資源檔的根名稱，不含副檔名但包括任何完整的命名空間。 例如，名為 MyApplication.MyResource.en-US.resources 的資源檔根目錄名稱是 MyApplication.MyResource。

assembly

Assembly

資源的主要組件。

usingResourceSet

Type

要使用之自訂 ResourceSet 的型別。 如果是 null，就會使用預設的執行階段 ResourceSet 物件。

例外狀況

ArgumentException

usingResourceset 不是 ResourceSet 的衍生類別。

ArgumentNullException

baseName 或 assembly 參數為 null。

備註

個別文化特性特定的資源文件應該包含在附屬元件中，而預設文化特性的資源文件應該包含在主要元件中。 假設附屬元件包含該元件指令清單中所指定之單一文化特性的資源，並視需要載入。

注意

若要直接從 .resources 檔案擷取資源，而不是從元件擷取資源，您必須改為呼叫 CreateFileBasedResourceManager 方法來具現化 ResourceManager 物件。

如果在 中找不到 所baseName識別的資源檔，方法就會具現化 ResourceManager 物件，但嘗試擷取特定資源會擲回例外狀況，通常是MissingManifestResourceException。assembly For information about diagnosing the cause of the exception, see the "Handling the MissingManifestResourceException Exception" section of the ResourceManager class topic.

注意

參數 usingResourceSet 是用來支援您自己的資源格式，而且通常為 null。 這與只接受的 Type 建構函式不同。

給呼叫者的注意事項

此建構函式可讓您指定 ResourceSet 實作。 如果您不想要特定 ResourceSet 實作，但想要使用自定義資源檔案格式，您應該衍生自 ResourceSet 類別、覆寫 GetDefaultReader() 和 GetDefaultWriter() 方法，然後將該類型傳遞至這個建構函式。