Reading and Writing RESX XML Files
| I l @ ve RuBoard |
| Resource files, as we mentioned at the beginning of this chapter, come in several flavors ” .resources files and .resx files. Resx files are the raw, uncompiled XML used as a basic source form for resources. In the previous example, we showed the ResourceReader and ResourceWriter classes. There are corresponding ResXResourceReader and ResXResourceWriter classes that can be used to maintain the XML forms of the resources. In our last example for this chapter, we've created a simple application that lets you load chosen bitmap, text, and icon files and convert these to a .RESX resource file (see Listing 3.4.8). The complexity of the task and the simplicity of this application show off some of the raw power of the Windows Forms architecture. Listing 3.4.8 ResXUtilForm.cs: The RESX Writer Utility 1: using System; 2: using System.Drawing; 3: using System.Collections; 4: using System.ComponentModel; 5: using System.Windows.Forms; 6: using System.Data; 7: using System.IO; 8: 9: /* 10: * NOTES: A bug in an early version of the .NET framework caused 11: * the program to raise an exception when the resource name is 12: * edited. In this file there are two sections of commented code 13: * that are designed to work around this problem 14: * If this code fails, simply uncomment the sections marked 15: * BUGFIXER and re-compile 16: * 17: */ 18: 19: namespace ResxUtil 20: { 21: /// <summary> 22: /// Summary description for Form1. 23: /// </summary> 24: public class ResXUtilForm : System.Windows.Forms.Form 25: { 26: private System.Windows.Forms.ListView listView1; 27: private System.Windows.Forms.Button button1; 28: private System.Windows.Forms.Button button2; 29: private System.Windows.Forms.ImageList imageList1; 30: private System.Windows.Forms.ColumnHeader columnHeader2; 31: private System.Windows.Forms.ColumnHeader columnHeader1; 32: private System.ComponentModel.IContainer components; 33: 34: public ResXUtilForm() 35: { 36: // 37: // Required for Windows Form Designer support 38: // 39: InitializeComponent(); 40: 41: //BUGFIXER uncomment the line below 42: //this.listView1.LabelEdit=false; 43: } 44: 45: /// <summary> 46: /// Clean up any resources being used. 47: /// </summary> 48: protected override void Dispose( bool disposing ) 49: { 50: if( disposing ) 51: { 52: if (components != null) 53: { 54: components.Dispose(); 55: } 56: } 57: base.Dispose( disposing ); 58: } 59: 60: #region Windows Form Designer generated code 61: /// <summary> 62: /// Required method for Designer support - do not modify 63: /// the contents of this method with the code editor. 64: /// </summary> 65: private void InitializeComponent() 66: { 67: this.components = new System.ComponentModel.Container(); 68: System.Resources.ResourceManager resources = new NOTE Be aware that the style of layout in this and other listings has been modified to fit an 80 column format. In particular, the InitializeComponent method has been modified from its original form. If you download the file from the Sams Web site, it might differ slightly in layout, but it will be functionally identical. By now, you should be able to go through the InitializeComponent and understand what's happening, so we'll just pick out highlights of the application. Lines 79 “80 create a set of column headers used when the ListView is in Detail mode to provide headers for each column of information. We have chosen to display the item icon from an ImageList plus the name of the resource, which you must choose, along with the full filename of the source resource. Lines 89 “92 set up the ImageList , bringing in the image stream and setting up sizes and transparent color and so on. Lines 98 “100 add the column headers to the list view control. Lines 93 “104 set the properties of the ListView to enable row selection (so you can delete an object from the list), label editing (which lets you name your resource, locations, and sizes for the control), and finally, the KeyDown handler (which only responds to the Delete key). Lines 110 “128 are the buttons . One adds a resource, the other saves the RESX file. Lines 155 “219 handle the Add button. This allows you to browse files (lines 154 and 155) for bitmaps, text, or icons. After you find a resource candidate, lines 168 “179 decide whether it's a file we care about and select the correct icon. Finally, lines 212 “217 use the icon selection to create a ListViewItem that has a label (at first "Undefined") and a sub-item that populates the second column of the list control with the filename. The Save button on lines 221 “284 does a quick check to see if all the resources have been named (lines 226 “233) and then gets a filename for the target file (lines 236 “240). Lines 243 “244 make a new ResXResourceWriter and then pass it into a foreach loop that goes through item by item and creates the resources. The switch statement (line 249) has three cases. Cases 0 and 2 are handled the same way because, for the XML format, there is no distinction between a bitmap and an icon. Case 1 (lines 254 “276) reads in the text file one line at a time and separates the lines into the name-value pairs used to create each text resource. The name is prefixed with the name you chose for the text file in the listbox. Note that this demonstration only understands text files with the "< name string >=< value string >" syntax. Other files are likely to give errors. After processing is done, lines 286 and 287 write and close the RESX file. Finally, lines 292 “300 handle the Delete key presses and remove items from the list if you want.
NOTE For applications built with Visual Studio, the complete solution is included as a zip archive on the Sams Web site (http://www.samspublishing.com). |
System.Resources.ResourceManager(typeof(ResXUtilForm)); 69: this.columnHeader2 = new System.Windows.Forms.ColumnHeader(); 70: this.columnHeader1 = new System.Windows.Forms.ColumnHeader(); 71: this.imageList1 = new System.Windows.Forms.ImageList(this.components); 72: this.listView1 = new System.Windows.Forms.ListView(); 73: this.button1 = new System.Windows.Forms.Button(); 74: this.button2 = new System.Windows.Forms.Button(); 75: this.SuspendLayout(); 76: // 77: // columnHeader2 78: // 79: this.columnHeader2.Text = "File name"; 80: this.columnHeader2.Width = 545; 81: // 82: // columnHeader1 83: // 84: this.columnHeader1.Text = "Resource name"; 85: this.columnHeader1.Width = 220; 86: // 87: // imageList1 88: // 89: this.imageList1.ColorDepth = System.Windows.Forms.ColorDepth.Depth8Bit; 90: this.imageList1.ImageSize = new System.Drawing.Size(16, 16); 91: this.imageList1.ImageStream = ((System.Windows.Forms.ImageListStreamer) | I l @ ve RuBoard |
EAN: 2147483647
Pages: 204