ResourceReader.GetResourceData(String, String, Byte[]) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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érationResourceTypeCode
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’espacePerson
de noms, qui se trouve dans laExtensions
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.