ResourceReader.GetResourceData(String, String, Byte[]) Méthode

Définition

Récupère le nom du type et les données d'une ressource nommée à partir d'un fichier de ressources ouvert ou d'un flux.

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())

Paramètres

resourceName
String

Nom d'une ressource.

resourceType
String

Quand cette méthode retourne une valeur, contient une chaîne qui représente le nom de type de la ressource récupérée. Ce paramètre est passé sans être initialisé.

resourceData
Byte[]

Lorsque cette méthode est retournée, contient un tableau d'octets correspondant à la représentation binaire du type récupéré. Ce paramètre est passé sans être initialisé.

Exceptions

resourceName a la valeur null.

resourceName n’existe pas.

resourceName a un type non valide.

Les données de ressources récupérées sont endommagées.

L'objet ResourceReader actuel n'est pas initialisé, probablement parce qu'il est fermé.

Remarques

La GetResourceData méthode récupère la valeur d’une ressource nommée sous la forme d’un tableau d’octets. Il est généralement utilisé lorsque la Value propriété lève une exception lorsqu’elle tente de récupérer la valeur d’une ressource.

resourceType est une chaîne qui représente le type de données de la ressource. Il peut s’agir de l’une des valeurs suivantes :

  • Représentation sous forme de chaîne d’un ResourceTypeCode membre d’énumération qui indique le type de données de la ressource. ResourceTypeCode est une énumération privée utilisée par .pour indiquer qu’un format binaire spécial est utilisé pour stocker l’un des 19 types de données courants. Ceux-ci incluent les types de données primitifs .NET Framework (Boolean, Byte, Int32DoubleInt64SingleInt16DecimalSByteChar, UInt16, UInt32, StringDateTimeUInt64TimeSpan. En outre, l’énumération ResourceTypeCode inclut les valeurs indiquées dans le tableau suivant.

    Valeur ResourceTypeCode Description
    ResourceTypeCode.ByteArray Les données sont un tableau d’octets. Ce type de données résulte généralement de l’appel à la ResourceWriter.AddResource(String, Byte[]) méthode.
    ResourceTypeCode.Null Les données sont une référence null. Ce type de données résulte généralement de l’appel à la ResourceWriter.AddResource(String, Object) méthode avec un objet dont la valeur est null.
    ResourceTypeCode.Stream Les données sont stockées dans un flux. Ce type de données résulte généralement de l’appel à la ResourceWriter.AddResource(String, Stream) méthode ou ResourceWriter.AddResource(String, Stream, Boolean) .

    En supposant qu’il resourceData n’a pas été endommagé, il peut généralement être converti à partir d’un tableau d’octets vers sa valeur d’origine en appelant une BitConverter méthode ou BinaryReader .

  • Chaîne qui contient le nom complet du type dont les données sérialisées sont affectées à l’argument resourceData (par exemple, System.String). En outre, pour les types qui ne font pas partie de la bibliothèque de classes .NET, la chaîne inclut le nom, la version, la culture et la clé publique de l’assembly qui contient le type. Par exemple, la chaîne suivante indique que les données sérialisées représentent une instance du type dans l’espace Person de noms, qui se trouve dans la Extensions version 1.0 d’un assembly nommé Utility qui n’a ni clé publique ni culture désignée.

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

  • Chaîne utilisée pour décrire le type de données dans l’appel de ResourceWriter.AddResourceData méthode.

S’applique à

Voir aussi