ResourceReader.GetResourceData(String, String, Byte[]) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Typnamen und die Daten einer benannten Ressource aus einer geöffneten Ressourcendatei oder einem geöffneten Datenstrom ab.
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
Der Name einer Ressource.
- resourceType
- String
Diese Methode gibt eine Zeichenfolge zurück, die den Typnamen der abgerufenen Ressource darstellt. Dieser Parameter wird nicht initialisiert übergeben.
- resourceData
- Byte[]
Wenn diese Methode beendet wird, enthält sie ein Bytearray, das die Binärdarstellung des abgerufenen Typs ist. Dieser Parameter wird nicht initialisiert übergeben.
Ausnahmen
resourceName
ist null
.
resourceName
existiert nicht.
resourceName
besitzt einen ungültigen Typ.
Die abgerufenen Ressourcendaten sind beschädigt.
Das aktuelle ResourceReader-Objekt wurde nicht initialisiert, weil es wahrscheinlich geschlossen ist.
Hinweise
Die GetResourceData -Methode ruft den Wert einer benannten Ressource als Bytearray ab. Es wird in der Regel verwendet, wenn die Value -Eigenschaft eine Ausnahme auslöst, wenn sie versucht, den Wert einer Ressource abzurufen.
resourceType
ist eine Zeichenfolge, die den Datentyp der Ressource darstellt. Dabei kann es sich um einen der folgenden Werte handeln:
Die Zeichenfolgendarstellung eines Enumerationsmembers
ResourceTypeCode
, der den Datentyp der Ressource angibt.ResourceTypeCode
ist eine private Enumeration, die von verwendet wird, um anzugeben, dass ein spezielles Binärformat zum Speichern eines von 19 gängigen Datentypen verwendet wird. Dazu gehören die .NET Framework primitiven Datentypen (Boolean, , CharByte, Decimal, SingleInt16Int64UInt16Int32UInt32SByteDouble), UInt64sowie String, DateTimeund TimeSpan. Darüber hinaus enthält dieResourceTypeCode
Enumeration die in der folgenden Tabelle gezeigten Werte.ResourceTypeCode-Wert BESCHREIBUNG ResourceTypeCode.ByteArray
Die Daten sind ein Bytearray. Dieser Datentyp ergibt sich in der Regel aus dem Aufruf der ResourceWriter.AddResource(String, Byte[]) -Methode. ResourceTypeCode.Null
Die Daten sind ein NULL-Verweis. Dieser Datentyp resultiert in der Regel aus dem Aufruf der ResourceWriter.AddResource(String, Object) -Methode mit einem -Objekt, dessen Wert ist null
.ResourceTypeCode.Stream
Die Daten werden in einem Stream gespeichert. Dieser Datentyp resultiert in der Regel aus dem Aufruf der - oder ResourceWriter.AddResource(String, Stream, Boolean) -ResourceWriter.AddResource(String, Stream)Methode. Unter der Annahme, dass
resourceData
nicht beschädigt wurde, kann es in der Regel von einem Bytearray zurück in den ursprünglichen Wert konvertiert werden, indem eine - oder BinaryReader -BitConverterMethode aufgerufen wird.Eine Zeichenfolge, die den vollqualifizierten Namen des Typs enthält, dessen serialisierte Daten dem
resourceData
Argument zugewiesen sind (z. BSystem.String
. ). Darüber hinaus enthält die Zeichenfolge für Typen, die nicht Teil der .NET-Klassenbibliothek sind, den Namen, die Version, die Kultur und den öffentlichen Schlüssel der Assembly, die den Typ enthält. Die folgende Zeichenfolge gibt z. B. an, dass die serialisierten Daten eine instance desPerson
Typs im Namespace darstellen, dieExtensions
in Version 1.0 einer Assembly namens Utility gefunden wird, die keinen öffentlichen Schlüssel und keine festgelegte Kultur aufweist.Extensions.Person, Utility, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null
Die Zeichenfolge, die verwendet wird, um den Datentyp im ResourceWriter.AddResourceData Methodenaufruf zu beschreiben.