FontNamesConverter.ConvertTo Methode

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erstellt eine Zeichenfolge, die eine Liste von Schriftartnamen darstellt, aus einem Array von Zeichenfolgen, das einzelne Schriftartnamen enthält.

public:
 override System::Object ^ ConvertTo(System::ComponentModel::ITypeDescriptorContext ^ context, System::Globalization::CultureInfo ^ culture, System::Object ^ value, Type ^ destinationType);

public override object ConvertTo (System.ComponentModel.ITypeDescriptorContext context, System.Globalization.CultureInfo culture, object value, Type destinationType);

override this.ConvertTo : System.ComponentModel.ITypeDescriptorContext * System.Globalization.CultureInfo * obj * Type -> obj

Public Overrides Function ConvertTo (context As ITypeDescriptorContext, culture As CultureInfo, value As Object, destinationType As Type) As Object

Parameter

context: ITypeDescriptorContext

Ein ITypeDescriptorContext-Objekt, das Informationen über den Kontext eines Typkonverters bereitstellt. Dieser Parameter wird bei dieser Methode nicht verwendet. Er ist für zukünftige Versionen der Methode vorgesehen. Für diesen Parameter kann optional null übergeben werden.

culture: CultureInfo

Ein CultureInfo-Objekt, das Informationen über eine Kultur, beispielsweise Sprache, Kalendersystem usw., darstellt. Dieser Parameter wird bei dieser Methode nicht verwendet. Er ist für zukünftige Versionen der Methode vorgesehen. Für diesen Parameter kann optional null übergeben werden.

value: Object

Ein Objekt, das das Ausgangsarray von Zeichenfolgen der Konvertierung darstellt.

destinationType: Type

Ein Object-Instanzobjekt, das den Datentyp darstellt, in den konvertiert werden soll. Dieser Parameter muss vom Typ String sein.

Gibt zurück

Object

Eine Object-Instanz, die eine Zeichenfolge mit einer Liste von Schriftartnamen darstellt.

Ausnahmen

NotSupportedException

destinationType ist nicht vom Typ String.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe der ConvertTo Methode ein Array von Zeichenfolgen konvertieren, das die einzelnen Namen in eine einzelne Zeichenfolge enthält, die eine Liste mit Schriftartnamen enthält.

<%@ 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>

Hinweise

Verwenden Sie die ConvertTo Methode, um ein Array von Zeichenfolgen mit den einzelnen Schriftartnamen in eine einzelne Zeichenfolge zu konvertieren, die eine Liste der Namen enthält. Ein Array, das z. B. die Zeichenfolgen "arial", "times new roman" und "verdana" in die Zeichenfolge "arial,times new roman,verdana" konvertiert. Beachten Sie, dass Kommas automatisch zwischen den Schriftartnamen ohne Leerzeichen eingefügt werden.

Hinweis

Dieser Konverter kann nur in einen string Datentyp konvertiert werden. Der destinationType Parameter muss vom Typ Stringsein.

Hinweis

Die context Parameter culture werden in dieser Version der Methode nicht verwendet. Sie sind für zukünftige Versionen der Methode reserviert. Sie können optional für diese Parameter übergeben null werden.

Gilt für