FontNamesConverter.ConvertTo Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Cria uma cadeia de caracteres que representa uma lista de nomes de fontes com base em uma matriz de cadeias de caracteres que contém os nomes de fontes individuais.
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
Parâmetros
- context
- ITypeDescriptorContext
Um objeto ITypeDescriptorContext que fornece informações sobre o contexto de um conversor de tipo. Este parâmetro não é usado neste método. Ele está reservado para versões futuras deste método. Opcionalmente, é possível passar null
para esse parâmetro.
- culture
- CultureInfo
Um objeto CultureInfo que representa informações sobre uma cultura, como o idioma, o sistema de calendário e assim por diante. Este parâmetro não é usado neste método. Ele está reservado para versões futuras deste método. Opcionalmente, é possível passar null
para esse parâmetro.
- value
- Object
Um objeto que representa a matriz da cadeia de caracteres de origem de conversão.
- destinationType
- Type
Um objeto de instância Object que representa o tipo de dados de conversão. O parâmetro precisa ser do tipo String.
Retornos
Uma instância Object que representa uma cadeia de caracteres que contém uma lista de nomes de fontes.
Exceções
destinationType
não é do tipo String.
Exemplos
O exemplo de código a seguir demonstra como usar o ConvertTo método para converter uma matriz de cadeias de caracteres que contém os nomes individuais em uma única cadeia de caracteres que contém uma lista de nomes de fonte.
<%@ 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>
Comentários
Use o ConvertTo método para converter uma matriz de cadeias de caracteres contendo os nomes de fonte individuais em uma única cadeia de caracteres que contém uma lista dos nomes. Por exemplo, uma matriz que contém as cadeias de caracteres "arial", "times new roman" e "verdana" converte na cadeia de caracteres "arial,times new roman,verdana". Observe que as vírgulas são inseridas automaticamente entre os nomes de fonte sem nenhum espaço em branco.
Observação
Esse conversor só pode ser convertido em um string
tipo de dados. O destinationType
parâmetro deve ser do tipo String.
Observação
Os context
parâmetros e culture
não são usados nesta versão do método; eles são reservados para versões futuras do método. Opcionalmente, você pode passar null
para esses parâmetros.