ResXFileRef Class

Reference

Definition

Namespace:: System.Resources

Assembly:: System.Windows.Forms.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Represents a link to an external resource.

public ref class ResXFileRef

[System.ComponentModel.TypeConverter(typeof(System.Resources.ResXFileRef+Converter))]
[System.Serializable]
public class ResXFileRef

[System.ComponentModel.TypeConverter(typeof(System.Resources.ResXFileRef+Converter))]
public class ResXFileRef

[<System.ComponentModel.TypeConverter(typeof(System.Resources.ResXFileRef+Converter))>]
[<System.Serializable>]
type ResXFileRef = class

[<System.ComponentModel.TypeConverter(typeof(System.Resources.ResXFileRef+Converter))>]
type ResXFileRef = class

Public Class ResXFileRef

Inheritance: Object
ResXFileRef

Attributes: TypeConverterAttribute SerializableAttribute

Remarks

The ResXFileRef class is used to include references to files in an XML resource (.resx) file. A ResXFileRef object represents a link to an external resource in an XML resource (.resx) file. You add the ResXFileRef object to a .resx file by calling the ResXResourceWriter.AddResource(ResXDataNode) method.

In a data entry in a .resx file, the type is ResXFileRef, and the value is the path location on disk. When the resource manager deserializes the object, the ResXFileRef performs the I/O to get the file. The following is an example of a .resx file.

<data name="iconclip" type="System.Resources.ResXFileRef, System.Windows.Forms">  
 <value>lookout.bmp;System.Drawing.Bitmap, System.Drawing</value>  
</data>  
<data name="mailbackground" type="System.Resources.ResXFileRef, System.Windows.Forms">  
 <value>mailbackground.bmp;System.Drawing.Bitmap, System.Drawing</value>  
</data>  
<data name="xplogo" type="System.Resources.ResXFileRef, System.Windows.Forms">  
 <value>xplogo.png;System.Drawing.Bitmap, System.Drawing</value>  
</data>

To add a ResXFileRef object to a .resx file programmatically, you call the ResXDataNode.ResXDataNode(String, ResXFileRef) constructor to instantiate a ResXDataNode object. You then pass this ResXDataNode object to the ResXResourceWriter.AddResource method.

When you compile a .resx file with Resgen.exe (Resource File Generator), the resources specified in the .resx file are embedded in the resulting document resource file.

Constructors

ResXFileRef(String, String)	Creates a new instance of the ResXFileRef class that references the specified file.
ResXFileRef(String, String, Encoding)	Initializes a new instance of the ResXFileRef class that references the specified file.

Properties

FileName	Gets the file name specified in the current ResXFileRef constructor.
TextFileEncoding	Gets the encoding specified in the current ResXFileRef constructor.
TypeName	Gets the type name specified in the current ResXFileRef constructor.

Methods

Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetType()	Gets the Type of the current instance. (Inherited from Object)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
ToString()	Gets the text representation of the current ResXFileRef object.

Applies to

Share via