Freigeben über


FontNamesConverter-Klasse

Konvertiert eine Zeichenfolge, die eine Liste von Schriftartnamen enthält, in ein Array von Zeichenfolgen, das die einzelnen Namen enthält. Auch der umgekehrte Vorgang kann durchgeführt werden.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Class FontNamesConverter
    Inherits TypeConverter
'Usage
Dim instance As FontNamesConverter
public class FontNamesConverter : TypeConverter
public ref class FontNamesConverter : public TypeConverter
public class FontNamesConverter extends TypeConverter
public class FontNamesConverter extends TypeConverter

Hinweise

Mithilfe der ConvertFrom-Methode dieser Klasse wird eine einzelne Zeichenfolge, die eine Liste von Schriftartnamen enthält, in ein Array von Zeichenfolgen konvertiert, das die einzelnen Namen enthält. Alle Schriftartnamen in der Zeichenfolge müssen durch Komma voneinander getrennt sein. Beispielsweise wird die Zeichenfolge "arial, times new roman, verdana" in ein Array konvertiert, das die Zeichenfolgen "arial", "times new roman" und "verdana" enthält. Beachten Sie, dass Kommas und Leerraum am Anfang oder Ende des Schriftartnamens entfernt werden. Leerraum innerhalb eines Schriftartnamens wird nicht entfernt.

Die ConvertTo-Methode führt den umgekehrten Vorgang durch. Sie konvertiert ein Array von Zeichenfolgen, das die einzelnen Schriftartnamen enthält, in eine einzige Zeichenfolge, die eine Liste der Namen enthält. Beispielsweise wird ein Array, das die Zeichenfolgen "arial", "times new roman" und "verdana" enthält, in die Zeichenfolge "arial,times new roman,verdana" konvertiert. Beachten Sie, dass Kommas automatisch und ohne Leerraum zwischen den einzelnen Schriftartnamen eingefügt werden.

Überprüfen Sie mithilfe der CanConvertFrom-Methode vor dem Ausführen der ConvertFrom-Methode, ob die Konvertierung durchgeführt werden kann.

Beispiel

Das folgende Beispiel veranschaulicht, wie mithilfe der FontNamesConverter-Klasse eine Zeichenfolge, die eine Liste von Schriftartnamen enthält, in ein Array von Zeichenfolgen konvertiert wird, das die einzelnen Namen enthält. Das Array von Zeichenfolgen wird dann in eine einzelne Zeichenfolge zurückkonvertiert und angezeigt.

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

<html>
<head>

   <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>
   <p>

   <form 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="C#" AutoEventWireup="True" %>

<html>
<head>

   <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>
   <p>

   <form 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>
   

.NET Framework-Sicherheit

Vererbungshierarchie

System.Object
   System.ComponentModel.TypeConverter
    System.Web.UI.WebControls.FontNamesConverter

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

FontNamesConverter-Member
System.Web.UI.WebControls-Namespace
System.ComponentModel.TypeConverter

Weitere Ressourcen

Gewusst wie: Implementieren eines Typkonverters
Beispiel für einen Typkonverter