FontNamesConverter Class

Reference

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.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.

Converts between a string containing a list of font names and an array of strings representing the individual names.

public ref class FontNamesConverter : System::ComponentModel::TypeConverter

public class FontNamesConverter : System.ComponentModel.TypeConverter

type FontNamesConverter = class
    inherit TypeConverter

Public Class FontNamesConverter
Inherits TypeConverter

Inheritance: Object

TypeConverter
FontNamesConverter

Examples

The following code example demonstrates how to use the FontNamesConverter class to convert a string with a list of font names to an array of strings containing the individual names. The array of strings is then converted back to a single string and displayed.

<%@ Page Language="C#" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>FontNamesConverter Example</title>
<script language="C#" runat="server">

      void Page_Load(Object sender, EventArgs e) 
      {

         // Declare local variables.
         System.Globalization.CultureInfo culture = new System.Globalization.CultureInfo("en");
         System.ComponentModel.ITypeDescriptorContext context = null;
         Object names; 
         Object name_string;

         // Create FontNamesConverter object.
         FontNamesConverter fontconverter = new FontNamesConverter();

         // Create original list of fonts.
         string font_list = "arial, times new roman, verdana";

         // Check for type compatibility.
         if (fontconverter.CanConvertFrom(context, typeof(string)))
         {

            // Display original string.
            Label1.Text = "Original String :" + "<br /><br />" + font_list;

            // Convert string to array to strings and display results.
            names = fontconverter.ConvertFrom(context, culture, font_list);
            Label2.Text = "Converted to Array of Strings : " + "<br /><br />";
            foreach (string name_element in (string[])names)
            {
               Label2.Text += name_element + "<br />";
            }

            // Convert array of strings back to a string and display results.
            name_string = fontconverter.ConvertTo(context, culture, names, typeof(string)); 
            Label3.Text = "Converted back to String :" + "<br /><br />" + (string)name_string;

         }
          
      }

   </script>

</head>
<body>

   <h3>FontNamesConverter Example</h3>
   <br />

   <form id="form1" runat="server">
        
      <asp:Label id="Label1" runat="server"/>
      <br /><hr />
      <asp:Label id="Label2" runat="server"/>
      <br /><hr />
      <asp:Label id="Label3" runat="server"/>
        
   </form>

</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>FontNamesConverter Example</title>
<script language="VB" runat="server">
    Sub Page_Load(sender As Object, e As EventArgs)
        
        ' Declare local variables.
        Dim culture As New System.Globalization.CultureInfo("en")
        Dim context As System.ComponentModel.ITypeDescriptorContext = Nothing
        Dim names As Object
        Dim name_string As Object
        
        ' Create FontNamesConverter object.
        Dim fontconverter As New FontNamesConverter()
        
        ' Create original list of fonts.
        Dim font_list As String = "arial, times new roman, verdana"
        
        ' Check for type compatibility.
        If fontconverter.CanConvertFrom(context, GetType(String)) Then
            
            ' Display original string.
            Label1.Text = "Original String :" & "<br /><br />" & font_list
            
            ' Convert string to array to strings and display results.
            names = fontconverter.ConvertFrom(context, culture, font_list)
            Label2.Text = "Converted to Array of Strings : " & "<br /><br />"
            Dim name_element As String
            For Each name_element In CType(names, String())
                Label2.Text &= name_element & "<br />"
            Next name_element
            
            ' Convert array of strings back to a string and display results.
            name_string = fontconverter.ConvertTo(context, culture, names, _
                GetType(String))
            Label3.Text = "Converted back to String :" & "<br /><br />" & _
                CType(name_string, String)
        End If 
    End Sub 'Page_Load
  </script>

</head>
<body>

   <h3>FontNamesConverter Example</h3>
   <br />

   <form id="form1" runat="server">
        
      <asp:Label id="Label1" runat="server"/>
      <br /><hr />
      <asp:Label id="Label2" runat="server"/>
      <br /><hr />
      <asp:Label id="Label3" runat="server"/>
        
   </form>

</body>
</html>

Remarks

Use the ConvertFrom method of this class to convert a single string containing a list of font names to an array of strings containing the individual names. Each font name in the string must be separated by a comma. For example, the string "arial, times new roman, verdana", converts to an array that contains the strings "arial", "times new roman", and "verdana". Notice the commas are removed along with any white space at the beginning or end of the font name. White space in the middle of a font name is not removed.

The ConvertTo method performs the reverse operation. It converts an array of strings containing the individual font names to a single string containing a list of the names. For example, an array that contains the strings "arial", "times new roman", and "verdana" converts to the string "arial,times new roman,verdana". Notice that commas are automatically inserted between the font names without any white space.

Call the CanConvertFrom method to verify that the conversion can be made before calling the ConvertFrom method.

Constructors

FontNamesConverter()

Initializes a new instance of the FontNamesConverter class.

Methods

CanConvertFrom(ITypeDescriptorContext, Type)	Determines whether this converter can convert an object of the specified data type to an array of strings containing individual font names.
CanConvertFrom(Type)	Returns whether this converter can convert an object of the given type to the type of this converter. (Inherited from TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)	Returns whether this converter can convert the object to the specified type, using the specified context. (Inherited from TypeConverter)
CanConvertTo(Type)	Returns whether this converter can convert the object to the specified type. (Inherited from TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)	Converts a string that represents a list of font names into an array of strings containing individual font names.
ConvertFrom(Object)	Converts the given value to the type of this converter. (Inherited from TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)	Converts the given string to the type of this converter, using the invariant culture and the specified context. (Inherited from TypeConverter)
ConvertFromInvariantString(String)	Converts the given string to the type of this converter, using the invariant culture. (Inherited from TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)	Converts the given text to an object, using the specified context and culture information. (Inherited from TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)	Converts the given text to an object, using the specified context. (Inherited from TypeConverter)
ConvertFromString(String)	Converts the specified text to an object. (Inherited from TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	Creates a string that represents a list of font names from an array of strings containing individual font names.
ConvertTo(Object, Type)	Converts the given value object to the specified type, using the arguments. (Inherited from TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)	Converts the specified value to a culture-invariant string representation, using the specified context. (Inherited from TypeConverter)
ConvertToInvariantString(Object)	Converts the specified value to a culture-invariant string representation. (Inherited from TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)	Converts the given value to a string representation, using the specified context and culture information. (Inherited from TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)	Converts the given value to a string representation, using the given context. (Inherited from TypeConverter)
ConvertToString(Object)	Converts the specified value to a string representation. (Inherited from TypeConverter)
CreateInstance(IDictionary)	Re-creates an Object given a set of property values for the object. (Inherited from TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)	Creates an instance of the type that this TypeConverter is associated with, using the specified context, given a set of property values for the object. (Inherited from TypeConverter)
Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetConvertFromException(Object)	Returns an exception to throw when a conversion cannot be performed. (Inherited from TypeConverter)
GetConvertToException(Object, Type)	Returns an exception to throw when a conversion cannot be performed. (Inherited from TypeConverter)
GetCreateInstanceSupported()	Returns whether changing a value on this object requires a call to the CreateInstance(IDictionary) method to create a new value. (Inherited from TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)	Returns whether changing a value on this object requires a call to CreateInstance(IDictionary) to create a new value, using the specified context. (Inherited from TypeConverter)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetProperties(ITypeDescriptorContext, Object, Attribute[])	Returns a collection of properties for the type of array specified by the value parameter, using the specified context and attributes. (Inherited from TypeConverter)
GetProperties(ITypeDescriptorContext, Object)	Returns a collection of properties for the type of array specified by the value parameter, using the specified context. (Inherited from TypeConverter)
GetProperties(Object)	Returns a collection of properties for the type of array specified by the value parameter. (Inherited from TypeConverter)
GetPropertiesSupported()	Returns whether this object supports properties. (Inherited from TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)	Returns whether this object supports properties, using the specified context. (Inherited from TypeConverter)
GetStandardValues()	Returns a collection of standard values from the default context for the data type this type converter is designed for. (Inherited from TypeConverter)
GetStandardValues(ITypeDescriptorContext)	Returns a collection of standard values for the data type this type converter is designed for when provided with a format context. (Inherited from TypeConverter)
GetStandardValuesExclusive()	Returns whether the collection of standard values returned from GetStandardValues() is an exclusive list. (Inherited from TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	Returns whether the collection of standard values returned from GetStandardValues() is an exclusive list of possible values, using the specified context. (Inherited from TypeConverter)
GetStandardValuesSupported()	Returns whether this object supports a standard set of values that can be picked from a list. (Inherited from TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)	Returns whether this object supports a standard set of values that can be picked from a list, using the specified context. (Inherited from TypeConverter)
GetType()	Gets the Type of the current instance. (Inherited from Object)
IsValid(ITypeDescriptorContext, Object)	Returns whether the given value object is valid for this type and for the specified context. (Inherited from TypeConverter)
IsValid(Object)	Returns whether the given value object is valid for this type. (Inherited from TypeConverter)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
SortProperties(PropertyDescriptorCollection, String[])	Sorts a collection of properties. (Inherited from TypeConverter)
ToString()	Returns a string that represents the current object. (Inherited from Object)

Applies to

Jaa