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

Définition

Espace de noms:

System.Resources

Assembly:

System.Runtime.dll

Source:

ResourceReader.Core.cs

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

ArgumentNullException

resourceName a la valeur null.

ArgumentException

resourceName n’existe pas.

BadImageFormatException

resourceName a un type non valide.

FormatException

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

InvalidOperationException

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.

Voir aussi

• AddResourceData(String, String, Byte[])