Cette documentation est archivée et n’est pas conservée.

StronglyTypedResourceBuilder, classe

Remarque : cette classe est nouvelle dans le .NET Framework version 2.0.

Fournit la prise en charge pour les ressources fortement typées. Cette classe ne peut pas être héritée.

Espace de noms : System.Resources.Tools
Assembly : System.Design (dans system.design.dll)

public static class StronglyTypedResourceBuilder
public final class StronglyTypedResourceBuilder
public final class StronglyTypedResourceBuilder

Le .NET Framework version 2.0 prend en charge les ressources fortement typées. La prise en charge des ressources fortement typées est une fonctionnalité de compilation qui encapsule l'accès aux ressources en créant des classes qui contiennent un jeu de propriétés statiques en lecture seule (get). Il s'agit là d'une autre manière de consommer des ressources, plutôt que d'utiliser les méthodes GetString et GetObject de la classe ResourceManager.

En général, les ressources séparent le code du contenu dans une application. La création et la consommation de ces ressources simplifient le développement d'applications localisables.

Dans le .NET Framework, une fois les ressources créées, elles sont généralement consommées à l'aide de la classe ResourceManager qui contient des méthodes donnant accès à des ressources spécifiques à la culture au moment de l'exécution. Pour plus d'informations sur ces processus, consultez Ressources dans les applications.

La prise en charge des ressources fortement typées est une alternative à l'utilisation de la classe ResourceManager pour consommer des ressources. Les fonctionnalités de base sont fournies par la classe StronglyTypedResourceBuilder (ainsi qu'une option de ligne de commande correspondante dans Outil Resource File Generator Tool (Resgen.exe)). La sortie de la méthode Create est une classe contenant des propriétés fortement typées qui correspondent aux ressources sont référencées dans le paramètre d'entrée. Cette classe fournit un accès fortement typé en lecture seule aux ressources disponibles dans le fichier traité.

L'exemple de code suivant génère une classe écrite en C#, se trouve dans l'espace de noms DemoApp, est nommé DemoResources et possède des propriétés qui retournent la bitmap d'un logo ainsi que le nom d'une application. Cet exemple de code utilise le fichier suivant, nommé demo.resx :

<data name="Logo" type="System.Drawing.Bitmap, System.Drawing, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" mimetype="application/x-microsoft.net.object.bytearray.base64">
<value>[base 64 encoded value omitted here]
</value>
</data>
<data name="MyAppTitle">
<value>Demo Application</value>
</data>

Appelez la méthode Create avec les arguments suivants :

StronglyTypedResourceBuilder.Create("demo.resx", "DemoResources", "DemoApp", new CSharpCodeProvider(), false, out errors[]) 

La méthode Create génère le code suivant :

using System;
using System.IO;
using System.Resources;

namespace DemoApp
{
public class DemoResources
{
protected static ResourceManager rm = new ResourceManager(typeof(className));
public static System.Resources.ResourceManager resourceManager 
{ 
get { return rm; }
}
public static System.Drawing.Bitmap Logo
{
get { return (System.Drawing.Bitmap)rm.GetObject(“logo”); }
}
    public static string MyAppTitle
    {
      get { return rm.GetString("MyAppTitle"); }
    }
}
}

Dans le code de votre application, vous pouvez ensuite utiliser la classe comme suit :

this.Text = DemoResources.MyAppTitle;
System.Drawing.Bitmap bmp = DemoResources.Logo;

System.Object
  System.Resources.Tools.StronglyTypedResourceBuilder

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0
Afficher: