ResourceReader.GetResourceData(String, String, Byte[]) Methode

Definition

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 die ResourceTypeCode 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. B System.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 des Person Typs im Namespace darstellen, die Extensions 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.

Gilt für:

Weitere Informationen